이미지 리소스 관리
Examples
// 한 개의 이미지를 로딩
collie.ImageManager.add("key", "sample.png");
new collie.DisplayObject({
backgroundImage: "key"
});
// 여러 이미지를 한 번에 로딩
collie.ImageManager.add({
image1 : "image1.png",
image2 : "image2.png"
}, function () {
alert("complete");
});
Members
-
staticcollie.ImageManager.load
-
- Deprecated
- add로 변경
-
staticcollie.ImageManager.mark
-
이미지를 사용 가능한 상태로 미리 만들어 놓는다. mark된 이미지는 DisplayObject에서 사용할 수 있다
- Deprecated
- 정의되지 않은 이름을 부를 때 자동으로 mark되도록 수정
-
staticcollie.ImageManager.RETRY_COUNTNumber
-
이미지 로딩 실패시 재시도 횟수
-
staticcollie.ImageManager.RETRY_DELAYNumber
-
이미지 로딩 실패시 재시도 딜레이 ms
-
staticcollie.ImageManager.USE_PRERENDERING_DOMBoolean
-
DOM일 때 css3d 엘리먼트를 미리 만들어놓는지 여부 - 기능 불안정으로 기본 사용 false로 변경, top, left를 멀리 보내버리면 3d 렌더링에 부담이 될 수 있다.
Methods
-
staticcollie.ImageManager.abort()
-
로드되고 있는 파일을 모두 멈춤
-
staticcollie.ImageManager.add()
-
이미지 리소스를 추가한다
Examples
// 1개의 이미지를 추가 collie.ImageManager.add("key", "sample.png", function () { // callback });
// 여러 개의 이미지를 추가 collie.ImageManager.add({ key : "sample.png", key2 : "sample2.png" }, function () { // callback });
-
staticcollie.ImageManager.addImage(sName, sURL, fCallback, fFail)
-
비동기로 이미지를 로딩
Name Type Description sName
String 이미지 이름, 이름이 없을 경우 Loader에 저장하지 않는다
sURL
String 이미지 주소
fCallback
Function 성공시 실행될 함수
Name Type Description elImage
HTMLElement 엘리먼트
sName
String 리소스 이름
sURL
String URL
fFail
Function 실패시 실행될 함수
-
staticcollie.ImageManager.addImages(htList, fCallback, fFail)
-
여러 개의 이미지 리소스를 한번에 추가 한다.
Name Type Description htList
Object { sName : sURL , sName2 : sURL2 }
fCallback
Function 선택한 파일이 모두 로드될 때 실행될 함수. 없으면 실행되지 않는다. 인자로 htList를 반환
fFail
Function 선택한 파일 중에 한개라도 로드되지 않았을 때 실행될 함수. 실패한 이미지의 [el, sName, sURL] 배열 목록을 인자로 갖는다
-
staticcollie.ImageManager.addSprite(sImageName, vSpriteName)
-
이미지에 스프라이트 시트 정보를 추가한다
Name Type Description sImageName
String collie.ImageManager에 등록된 이미지 이름
vSpriteName
String | Object 객체로 한 번에 여러 개의 정보를 등록할 수 있음
Example
collie.ImageManager.add({ "sample" : "sample.png" });
// Add Sprites with key-value object collie.ImageManager.addSprite("sample", { normal : [0, 0], // [offsetX, offsetY] action : [30, 0], jump : [60, 0, 30, 30, 8] // [startOffsetX, startOffsetY, a width per one frame, a height per one frame, spriteLength] });
// or Add Sprites with array collie.ImageManager.addSprite("sample", [ [0, 0], // key 0 [30, 0], // key 1 [60, 0, 30, 30, 8] // key 2 and [startOffsetX, startOffsetY, a width per one frame, a height per one frame, spriteLength] ]);
var item = new collie.DisplayObject({ spriteSheet : "normal", // or 0 backgroundImage : "sample" });
// with Timer collie.Timer.cycle(item, 1000, { from: 0, to: 1, set: "spriteSheet" });
// If you use five parameters in the addSprite method, you can use spriteX option with spriteSheet item.set("spriteSheet", "jump"); collie.Timer.cycle(item, 1000, { from: 0, to: 7 // spriteLength 8 });
-
staticcollie.ImageManager.getImage(sName, fCallback){HTMLElement}
-
이미지를 가져온다
Name Type Description sName
String 리소스 이름
fCallback
Function 리소스가 로드되지 않았을 수도 있으므로 콜백으로 처리
-
staticcollie.ImageManager.remove()
-
이미지를 삭제한다
-
staticcollie.ImageManager.removeImage(sName)
-
이미지를 삭제한다
Name Type Description sName
String 리소스 이름
-
staticcollie.ImageManager.removeSprite(sImageName)
-
스프라이트 정보를 제거한다
Name Type Description sImageName
String collie.ImageManager에 등록된 이미지 이름
-
staticcollie.ImageManager.reset()
-
등록된 파일을 모두 제거
Events
-
complete
-
등록된 이미지가 모두 로드 되었을 경우
Name Type Description oEvent
Object -
error
-
한 개의 이미지가 로딩 실패 했을 때 실행
Name Type Description oEvent
Object Name Type Description name
String 실패된 이미지 이름
url
String 실패된 이미지 URL
count
Number 현재 로딩된 갯수
total
Number 전체 이미지 갯수
-
process
-
한개의 이미지가 로딩되었을 때 발생
Name Type Description oEvent
Object Name Type Description name
String 이미지 이름
url
String 이미지 URL
count
Number 현재 로딩된 갯수
total
Number 전체 이미지 갯수
ratio
Number 로딩된 이미지의 비율 (0~1)
-
retry
-
한 개의 이미지가 로딩 실패 했을 때 실행
Name Type Description oEvent
Object Name Type Description name
String 실패된 이미지 이름
url
String 실패된 이미지 URL
count
Number 현재 로딩된 갯수
total
Number 전체 이미지 갯수