태그 제거 함수 (asset_remove_tags)
이 문서는 asset_remove_tags 함수에 대해 설명합니다. 이 함수는 자산 브라우저에서 하나 이상의 태그 문자열을 삭제하는 데 사용됩니다. 아래에서 이 함수의 사용법과 예제를 설명하겠습니다.
함수 설명
asset_remove_tags 함수는 다음과 같은 인수들을 받습니다:
- name_or_index: 자산의 이름(문자열) 또는 자산 인덱스.
- tags: 삭제할 태그의 문자열 또는 문자열 배열.
- [asset_type]: (선택 사항) 자산 핸들을 제공할 경우, 자산의 유형을 지정하는 상수.
사용 가능한 자산 유형
| 자산 유형 | 설명 |
|---|---|
asset_object |
객체 자산 |
asset_sound |
사운드 자산 |
asset_background |
배경 자산 |
asset_sprite |
스프라이트 자산 |
asset_shader |
셰이더 자산 |
asset_sound |
사운드 자산 |
asset_font |
글꼴 자산 |
asset_script |
스크립트 자산 |
asset_tile |
타일 자산 |
asset_buff |
버프 자산 |
반환 값
- 성공적으로 태그를 제거하면
true를 반환하고, 그렇지 않으면false를 반환합니다.
문법
asset_remove_tags(name_or_index, tags, [asset_type]);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
name_or_index |
String 또는 Asset | 자산의 이름 또는 핸들 |
tags |
String 또는 Array | 하나의 자산 태그 문자열 또는 여러 태그의 배열 |
[asset_type] |
Asset Type Constant | 자산에서 태그를 제거할 때 사용할 자산 유형 (선택 사항) |
예제
다음 코드는 태그 배열을 생성한 후 지정된 객체에서 해당 태그를 제거하는 예제입니다.
var _a = array_create(3);
_a[0] = "enemy";
_a[1] = "all_levels";
_a[2] = "boss";
asset_remove_tags(obj_Enemy_Boss_Parent, _a, asset_object);
위 코드를 실행하면 obj_Enemy_Boss_Parent 객체에서 enemy, all_levels, boss 태그가 제거됩니다.
다양한 활용 및 응용 예제
- 게임의 적 객체에서 특정 태그 제거하기
gml var _tags_to_remove = ["slow", "stun"]; asset_remove_tags(obj_Enemy_Slow, _tags_to_remove, asset_object);
이 코드는 느린 적 객체에서 slow와 stun 태그를 제거합니다.
- 사운드 자산에서 여러 태그 제거하기
gml var _sound_tags = ["background", "menu"]; asset_remove_tags(sound_main_theme, _sound_tags, asset_sound);
이 코드는 주요 테마 사운드에서 background와 menu 태그를 제거합니다.
- 모든 레벨에 적용된 태그 빠르게 제거하기
gml var _level_tags = ["all_levels", "common"]; asset_remove_tags(asset_index("Level1"), _level_tags, asset_background);
이 코드는 Level1 자산에서 모든 레벨에 적용된 태그를 제거합니다.
이 정보를 통해 asset_remove_tags 함수를 효과적으로 사용할 수 있습니다. 필요에 따라 다양한 자산에서 태그를 제거하는 데 활용해 보세요!