이미지 리소스 관리
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 sNameString 이미지 이름, 이름이 없을 경우 Loader에 저장하지 않는다
sURLString 이미지 주소
fCallbackFunction 성공시 실행될 함수
Name Type Description elImageHTMLElement 엘리먼트
sNameString 리소스 이름
sURLString URL
fFailFunction 실패시 실행될 함수
-
staticcollie.ImageManager.addImages(htList, fCallback, fFail)
-
여러 개의 이미지 리소스를 한번에 추가 한다.
Name Type Description htListObject { sName : sURL , sName2 : sURL2 }
fCallbackFunction 선택한 파일이 모두 로드될 때 실행될 함수. 없으면 실행되지 않는다. 인자로 htList를 반환
fFailFunction 선택한 파일 중에 한개라도 로드되지 않았을 때 실행될 함수. 실패한 이미지의 [el, sName, sURL] 배열 목록을 인자로 갖는다
-
staticcollie.ImageManager.addSprite(sImageName, vSpriteName)
-
이미지에 스프라이트 시트 정보를 추가한다
Name Type Description sImageNameString collie.ImageManager에 등록된 이미지 이름
vSpriteNameString | 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 sNameString 리소스 이름
fCallbackFunction 리소스가 로드되지 않았을 수도 있으므로 콜백으로 처리
-
staticcollie.ImageManager.remove()
-
이미지를 삭제한다
-
staticcollie.ImageManager.removeImage(sName)
-
이미지를 삭제한다
Name Type Description sNameString 리소스 이름
-
staticcollie.ImageManager.removeSprite(sImageName)
-
스프라이트 정보를 제거한다
Name Type Description sImageNameString collie.ImageManager에 등록된 이미지 이름
-
staticcollie.ImageManager.reset()
-
등록된 파일을 모두 제거
Events
-
complete
-
등록된 이미지가 모두 로드 되었을 경우
Name Type Description oEventObject -
error
-
한 개의 이미지가 로딩 실패 했을 때 실행
Name Type Description oEventObject Name Type Description nameString 실패된 이미지 이름
urlString 실패된 이미지 URL
countNumber 현재 로딩된 갯수
totalNumber 전체 이미지 갯수
-
process
-
한개의 이미지가 로딩되었을 때 발생
Name Type Description oEventObject Name Type Description nameString 이미지 이름
urlString 이미지 URL
countNumber 현재 로딩된 갯수
totalNumber 전체 이미지 갯수
ratioNumber 로딩된 이미지의 비율 (0~1)
-
retry
-
한 개의 이미지가 로딩 실패 했을 때 실행
Name Type Description oEventObject Name Type Description nameString 실패된 이미지 이름
urlString 실패된 이미지 URL
countNumber 현재 로딩된 갯수
totalNumber 전체 이미지 갯수