_character_customization.csc File Reference

Go to the source code of this file.

Macros
#define	ANIM_NOTIFY   "_anim_notify_"
#define	DEFAULT_LIVE_CHARACTER_EXPLODER   "char_customization"
#define	HEAD_MESH_LODS   STREAM_LOD_HIGHEST
#define	HEAD_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST
#define	HELMET_MESH_LODS   STREAM_LOD_HIGHEST
#define	HELMET_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST
#define	HERO_CUSTOMIZE_IDLE_ANIM   "pb_cac_main_lobby_idle"
#define	HERO_HEAD_BONE   ""
#define	HERO_HELMET_BONE   ""
#define	HERO_LOBBY_CLIENT_IDLE_ANIM   "pb_cac_vs_screen_idle_1"
#define	HERO_MESH_LODS   STREAM_LOD_HIGHEST
#define	HERO_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST
#define	HERO_WEAPON_BONE   "tag_weapon_right"
#define	LIVE_CHARACTER_SPAWN_TARGET   "character_customization"
#define	LOCAL_WEAPON_PAINTSHOP_CLASS   2
#define	RS_ROTATION_SPEED_MULTIPLIER   3.0
#define	SHOWCASE_WEAPON_PAINTSHOP_CLASS   1

Functions
function	__init__ ()
function	create_character_data_struct (characterModel, localClientNum, alt_render_mode=true)
function	get_character_body (localClientNum, characterMode, characterIndex, extracamData)
function	get_character_body_color (localClientNum, characterMode, characterIndex, bodyIndex, colorSlot, extracamData)
function	get_character_body_colors (localClientNum, characterMode, characterIndex, bodyIndex, extracamData)
function	get_character_head (localClientNum, characterMode, extracamData)
function	get_character_helmet (localClientNum, characterMode, characterIndex, extracamData)
function	get_character_helmet_color (localClientNum, characterMode, characterIndex, helmetIndex, colorSlot, extracamData)
function	get_character_helmet_colors (localClientNum, characterMode, characterIndex, helmetIndex, extracamData)
function	get_character_mode (localClientNum)
function	get_character_showcase_weapon (localClientNum, characterMode, characterIndex, extracamData)
function	get_current_frozen_moment_params (localClientNum, data_struct, params)
function	handle_forced_streaming (game_mode)
function	is_character_streamed (data_struct)
function	loadEquippedCharacterOnModel (localClientNum, data_struct, characterIndex, params)
function	localClientConnect (localClientNum)
function	play_intro_and_animation (intro_anim_name, anim_name, b_keep_link)
function	process_character_body_item_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, characterIndex, itemIndex, defaultImageRender)
function	process_character_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, characterIndex)
function	process_character_head_item_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, headIndex, defaultImageRender)
function	process_character_helmet_item_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, characterIndex, itemIndex, defaultImageRender)
function	process_current_hero_headshot_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, characterIndex, isDefaultHero)
function	process_lobby_client_character_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode)
function	process_outfit_preview_extracam_request (localClientNum, jobIndex, extraCamIndex, sessionMode, outfitIndex)
function	reaper_body3_hack (params)
function	rotation_thread_spawner (localClientNum, data_struct, endOnEvent)
function	set_body (data_struct, mode, characterIndex, bodyIndex, bodyColors)
function	set_body_color (data_struct, colorSlot, colorIndex)
function	set_body_colors (data_struct, mode, bodyColors)
function	set_character (data_struct, characterIndex)
function	set_character_align (localClientNum, data_struct, align_target)
function	set_character_mode (data_struct, characterMode)
function	set_head (data_struct, mode, headIndex)
function	set_helmet (data_struct, mode, characterIndex, helmetIndex, helmetColors)
function	set_helmet_color (data_struct, colorSlot, colorIndex)
function	set_helmet_colors (data_struct, colors)
function	set_showcase_weapon (data_struct, mode, localClientNum, xuid, characterIndex, showcaseWeaponName, showcaseWeaponAttachmentInfo, weaponRenderOptions, useShowcasePaintjob, useLocalPaintshop)
function	setup_character_extracam_settings (localClientNum, data_struct, extracam_data_struct)
function	setup_character_extracam_struct (xcam, subXCam, model_animation, useLobbyPlayers)
function	setup_character_streaming (data_struct)
function	setup_live_character_customization_target (localClientNum)
function	setup_static_character_customization_target (localClientNum)
function	update (localClientNum, data_struct, params)
function	update_character_animation_and_attachments (localClientNum, data_struct, params)
function	update_character_animation_based_on_showcase_weapon (data_struct, params)
function	update_character_animation_tree_for_scene (characterModel)
function	update_character_extracam (localClientNum, data_struct)
function	update_locked_shader (localClientNum, params)
function	update_model_attachment (localClientNum, data_struct, attached_model, slot, model_anim, model_intro_anim, force_update)
function	update_model_rotation_for_right_stick (localClientNum, data_struct, endOnEvent)
function	update_show_helmets (localClientNum, data_struct, show_helmets)
function	update_use_frozen_moments (localClientNum, data_struct, useFrozenMoments)
function	updateEventThread (localClientNum, data_struct)
function	wait_for_extracam_close (localClientNum, camera_ent, extraCamIndex)

Macro Definition Documentation

ANIM_NOTIFY

#define ANIM_NOTIFY   "_anim_notify_"

Definition at line 225 of file _character_customization.csc.

DEFAULT_LIVE_CHARACTER_EXPLODER

#define DEFAULT_LIVE_CHARACTER_EXPLODER   "char_customization"

Definition at line 37 of file _character_customization.csc.

HEAD_MESH_LODS

#define HEAD_MESH_LODS   STREAM_LOD_HIGHEST

Definition at line 33 of file _character_customization.csc.

HEAD_TEXTURE_LODS

#define HEAD_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST

Definition at line 34 of file _character_customization.csc.

HELMET_MESH_LODS

#define HELMET_MESH_LODS   STREAM_LOD_HIGHEST

Definition at line 30 of file _character_customization.csc.

HELMET_TEXTURE_LODS

#define HELMET_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST

Definition at line 31 of file _character_customization.csc.

HERO_CUSTOMIZE_IDLE_ANIM

#define HERO_CUSTOMIZE_IDLE_ANIM   "pb_cac_main_lobby_idle"

Definition at line 23 of file _character_customization.csc.

HERO_HEAD_BONE

#define HERO_HEAD_BONE   ""

Definition at line 21 of file _character_customization.csc.

HERO_HELMET_BONE

#define HERO_HELMET_BONE   ""

Definition at line 20 of file _character_customization.csc.

HERO_LOBBY_CLIENT_IDLE_ANIM

#define HERO_LOBBY_CLIENT_IDLE_ANIM   "pb_cac_vs_screen_idle_1"

Definition at line 24 of file _character_customization.csc.

HERO_MESH_LODS

#define HERO_MESH_LODS   STREAM_LOD_HIGHEST

Definition at line 27 of file _character_customization.csc.

HERO_TEXTURE_LODS

#define HERO_TEXTURE_LODS   STREAM_MIP_EXCLUDE_HIGHEST

Definition at line 28 of file _character_customization.csc.

HERO_WEAPON_BONE

#define HERO_WEAPON_BONE   "tag_weapon_right"

Definition at line 22 of file _character_customization.csc.

LIVE_CHARACTER_SPAWN_TARGET

#define LIVE_CHARACTER_SPAWN_TARGET   "character_customization"

Definition at line 36 of file _character_customization.csc.

LOCAL_WEAPON_PAINTSHOP_CLASS

#define LOCAL_WEAPON_PAINTSHOP_CLASS   2

Definition at line 40 of file _character_customization.csc.

RS_ROTATION_SPEED_MULTIPLIER

#define RS_ROTATION_SPEED_MULTIPLIER   3.0

Definition at line 25 of file _character_customization.csc.

SHOWCASE_WEAPON_PAINTSHOP_CLASS

#define SHOWCASE_WEAPON_PAINTSHOP_CLASS   1

Definition at line 39 of file _character_customization.csc.

Function Documentation

__init__()

function __init__

(

)

Definition at line 49 of file _character_customization.csc.

References DEFAULT, HERO_HEAD_BONE, HERO_HELMET_BONE, localClientConnect(), process_character_body_item_extracam_request(), process_character_extracam_request(), process_character_head_item_extracam_request(), process_character_helmet_item_extracam_request(), process_current_hero_headshot_extracam_request(), process_lobby_client_character_extracam_request(), and process_outfit_preview_extracam_request().

create_character_data_struct()

function create_character_data_struct	(	characterModel	,
		localClientNum	,
		alt_render_mode	= true
	)

Definition at line 82 of file _character_customization.csc.

References array, DEFAULT, and SESSIONMODE_INVALID.

Referenced by linkToCustomCharacter(), setup_live_character_customization_target(), and setup_static_character_customization_target().

get_character_body()

function get_character_body	(	localClientNum	,
		characterMode	,
		characterIndex	,
		extracamData
	)

Definition at line 653 of file _character_customization.csc.

References IS_TRUE, and SESSIONMODE_CAMPAIGN.

Referenced by loadEquippedCharacterOnModel().

get_character_body_color()

function get_character_body_color	(	localClientNum	,
		characterMode	,
		characterIndex	,
		bodyIndex	,
		colorSlot	,
		extracamData
	)

Definition at line 690 of file _character_customization.csc.

References IS_TRUE.

Referenced by get_character_body_colors().

get_character_body_colors()

function get_character_body_colors	(	localClientNum	,
		characterMode	,
		characterIndex	,
		bodyIndex	,
		extracamData
	)

Definition at line 710 of file _character_customization.csc.

References get_character_body_color().

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

get_character_head()

function get_character_head	(	localClientNum	,
		characterMode	,
		extracamData
	)

Definition at line 728 of file _character_customization.csc.

References IS_TRUE.

Referenced by loadEquippedCharacterOnModel().

get_character_helmet()

function get_character_helmet	(	localClientNum	,
		characterMode	,
		characterIndex	,
		extracamData
	)

Definition at line 752 of file _character_customization.csc.

References IS_TRUE.

Referenced by loadEquippedCharacterOnModel().

get_character_helmet_color()

function get_character_helmet_color	(	localClientNum	,
		characterMode	,
		characterIndex	,
		helmetIndex	,
		colorSlot	,
		extracamData
	)

Definition at line 796 of file _character_customization.csc.

References IS_TRUE.

Referenced by get_character_helmet_colors().

get_character_helmet_colors()

function get_character_helmet_colors	(	localClientNum	,
		characterMode	,
		characterIndex	,
		helmetIndex	,
		extracamData
	)

Definition at line 816 of file _character_customization.csc.

References get_character_helmet_color().

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

get_character_mode()

function get_character_mode

(

localClientNum

)

Definition at line 648 of file _character_customization.csc.

get_character_showcase_weapon()

function get_character_showcase_weapon	(	localClientNum	,
		characterMode	,
		characterIndex	,
		extracamData
	)

Definition at line 776 of file _character_customization.csc.

References IS_TRUE.

Referenced by loadEquippedCharacterOnModel().

get_current_frozen_moment_params()

function get_current_frozen_moment_params	(	localClientNum	,
		data_struct	,
		params
	)

Definition at line 854 of file _character_customization.csc.

References get(), reaper_body3_hack(), and SET_IF_DEFINED.

Referenced by update_character_animation_and_attachments().

handle_forced_streaming()

function handle_forced_streaming

(

game_mode

)

Definition at line 148 of file _character_customization.csc.

References HEAD_MESH_LODS, HEAD_TEXTURE_LODS, HELMET_MESH_LODS, HELMET_TEXTURE_LODS, HERO_MESH_LODS, and HERO_TEXTURE_LODS.

is_character_streamed()

function is_character_streamed

(

data_struct

)

Definition at line 607 of file _character_customization.csc.

Referenced by setup_character_extracam_settings(), and updateEventThread().

loadEquippedCharacterOnModel()

function loadEquippedCharacterOnModel	(	localClientNum	,
		data_struct	,
		characterIndex	,
		params
	)

Definition at line 179 of file _character_customization.csc.

References get_character_body(), get_character_body_colors(), get_character_head(), get_character_helmet(), get_character_helmet_colors(), get_character_showcase_weapon(), IS_TRUE, set_body(), set_character(), set_character_mode(), set_head(), set_helmet(), set_showcase_weapon(), update(), and VAL.

Referenced by setup_character_extracam_settings(), and updateEventThread().

localClientConnect()

function localClientConnect

(

localClientNum

)

Definition at line 70 of file _character_customization.csc.

References setup_character_streaming(), setup_live_character_customization_target(), and setup_static_character_customization_target().

Referenced by __init__().

play_intro_and_animation()

function play_intro_and_animation	(	intro_anim_name	,
		anim_name	,
		b_keep_link
	)

Definition at line 895 of file _character_customization.csc.

References play().

Referenced by update_character_animation_and_attachments(), and update_model_attachment().

process_character_body_item_extracam_request()

function process_character_body_item_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		characterIndex	,
		itemIndex	,
		defaultImageRender
	)

Definition at line 1443 of file _character_customization.csc.

References HERO_LOBBY_CLIENT_IDLE_ANIM, and setup_character_extracam_struct().

Referenced by __init__().

process_character_extracam_request()

function process_character_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		characterIndex
	)

Definition at line 1402 of file _character_customization.csc.

Referenced by __init__().

process_character_head_item_extracam_request()

function process_character_head_item_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		headIndex	,
		defaultImageRender
	)

Definition at line 1489 of file _character_customization.csc.

References HERO_LOBBY_CLIENT_IDLE_ANIM, and setup_character_extracam_struct().

Referenced by __init__().

process_character_helmet_item_extracam_request()

function process_character_helmet_item_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		characterIndex	,
		itemIndex	,
		defaultImageRender
	)

Definition at line 1465 of file _character_customization.csc.

References HERO_LOBBY_CLIENT_IDLE_ANIM, and setup_character_extracam_struct().

Referenced by __init__().

process_current_hero_headshot_extracam_request()

function process_current_hero_headshot_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		characterIndex	,
		isDefaultHero
	)

Definition at line 1422 of file _character_customization.csc.

Referenced by __init__().

process_lobby_client_character_extracam_request()

function process_lobby_client_character_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode
	)

Definition at line 1412 of file _character_customization.csc.

Referenced by __init__().

process_outfit_preview_extracam_request()

function process_outfit_preview_extracam_request	(	localClientNum	,
		jobIndex	,
		extraCamIndex	,
		sessionMode	,
		outfitIndex
	)

Definition at line 1433 of file _character_customization.csc.

Referenced by __init__().

reaper_body3_hack()

function reaper_body3_hack

(

params

)

Definition at line 843 of file _character_customization.csc.

Referenced by get_current_frozen_moment_params(), and update_character_animation_and_attachments().

rotation_thread_spawner()

function rotation_thread_spawner	(	localClientNum	,
		data_struct	,
		endOnEvent
	)

Definition at line 1245 of file _character_customization.csc.

References IS_TRUE, and update_model_rotation_for_right_stick().

set_body()

function set_body	(	data_struct	,
		mode	,
		characterIndex	,
		bodyIndex	,
		bodyColors
	)

Definition at line 311 of file _character_customization.csc.

References IS_TRUE, SESSIONMODE_CAMPAIGN, SESSIONMODE_INVALID, and set_body_colors().

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

set_body_color()

function set_body_color	(	data_struct	,
		colorSlot	,
		colorIndex
	)

Definition at line 346 of file _character_customization.csc.

Referenced by set_body_colors(), and updateEventThread().

set_body_colors()

function set_body_colors	(	data_struct	,
		mode	,
		bodyColors
	)

Definition at line 338 of file _character_customization.csc.

References set_body_color().

Referenced by set_body().

set_character()

function set_character	(	data_struct	,
		characterIndex
	)

Definition at line 299 of file _character_customization.csc.

Referenced by loadEquippedCharacterOnModel().

set_character_align()

function set_character_align	(	localClientNum	,
		data_struct	,
		align_target
	)

Definition at line 1071 of file _character_customization.csc.

References update().

set_character_mode()

function set_character_mode	(	data_struct	,
		characterMode
	)

Definition at line 304 of file _character_customization.csc.

Referenced by loadEquippedCharacterOnModel().

set_head()

function set_head	(	data_struct	,
		mode	,
		headIndex
	)

Definition at line 354 of file _character_customization.csc.

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

set_helmet()

function set_helmet	(	data_struct	,
		mode	,
		characterIndex	,
		helmetIndex	,
		helmetColors
	)

Definition at line 363 of file _character_customization.csc.

References set_helmet_colors().

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

set_helmet_color()

function set_helmet_color	(	data_struct	,
		colorSlot	,
		colorIndex
	)

Definition at line 564 of file _character_customization.csc.

Referenced by set_helmet_colors(), and updateEventThread().

set_helmet_colors()

function set_helmet_colors	(	data_struct	,
		colors
	)

Definition at line 553 of file _character_customization.csc.

References set_helmet_color().

Referenced by set_helmet().

set_showcase_weapon()

function set_showcase_weapon	(	data_struct	,
		mode	,
		localClientNum	,
		xuid	,
		characterIndex	,
		showcaseWeaponName	,
		showcaseWeaponAttachmentInfo	,
		weaponRenderOptions	,
		useShowcasePaintjob	,
		useLocalPaintshop
	)

Definition at line 371 of file _character_customization.csc.

References CUSTOMIZATION_INVALID_PAINTJOB_INDEX, CUSTOMIZATION_INVALID_PAINTJOB_SLOT, INSPECTION_POSE_ZM, LOCAL_WEAPON_PAINTSHOP_CLASS, SESSIONMODE_ZOMBIES, SHOWCASE_WEAPON_PAINTSHOP_CLASS, and WEAPON_GROUP_FRONTEND_ANIMS.

Referenced by loadEquippedCharacterOnModel(), and updateEventThread().

setup_character_extracam_settings()

function setup_character_extracam_settings	(	localClientNum	,
		data_struct	,
		extracam_data_struct
	)

Definition at line 1337 of file _character_customization.csc.

References DEFAULT, extracam_init_index(), is_character_streamed(), IS_TRUE, loadEquippedCharacterOnModel(), WAIT_CLIENT_FRAME, and wait_for_extracam_close().

Referenced by update_character_extracam().

setup_character_extracam_struct()

function setup_character_extracam_struct	(	xcam	,
		subXCam	,
		model_animation	,
		useLobbyPlayers
	)

Definition at line 1321 of file _character_customization.csc.

Referenced by process_character_body_item_extracam_request(), process_character_head_item_extracam_request(), process_character_helmet_item_extracam_request(), and setup_static_character_customization_target().

setup_character_streaming()

function setup_character_streaming

(

data_struct

)

Definition at line 631 of file _character_customization.csc.

Referenced by localClientConnect().

setup_live_character_customization_target()

function setup_live_character_customization_target

(

localClientNum

)

Definition at line 1088 of file _character_customization.csc.

References create_character_data_struct(), DEFAULT_LIVE_CHARACTER_EXPLODER, LIVE_CHARACTER_SPAWN_TARGET, and updateEventThread().

Referenced by localClientConnect().

setup_static_character_customization_target()

function setup_static_character_customization_target

(

localClientNum

)

Definition at line 1302 of file _character_customization.csc.

References create_character_data_struct(), HERO_CUSTOMIZE_IDLE_ANIM, HERO_LOBBY_CLIENT_IDLE_ANIM, setup_character_extracam_struct(), and update_character_extracam().

Referenced by localClientConnect().

update()

function update	(	localClientNum	,
		data_struct	,
		params
	)

Definition at line 572 of file _character_customization.csc.

References IS_TRUE, update_character_animation_and_attachments(), update_model_attachment(), and VAL.

Referenced by loadEquippedCharacterOnModel(), set_character_align(), update_show_helmets(), and updateEventThread().

update_character_animation_and_attachments()

function update_character_animation_and_attachments	(	localClientNum	,
		data_struct	,
		params
	)

Definition at line 918 of file _character_customization.csc.

References cancelGesture(), cancelTaunt(), DEFAULT, get(), get_current_frozen_moment_params(), IS_TRUE, play(), play_intro_and_animation(), reaper_body3_hack(), stop(), update_character_animation_based_on_showcase_weapon(), update_character_animation_tree_for_scene(), and update_model_attachment().

Referenced by update(), update_use_frozen_moments(), and updateEventThread().

update_character_animation_based_on_showcase_weapon()

function update_character_animation_based_on_showcase_weapon	(	data_struct	,
		params
	)

Definition at line 907 of file _character_customization.csc.

Referenced by update_character_animation_and_attachments().

update_character_animation_tree_for_scene()

function update_character_animation_tree_for_scene

(

characterModel

)

Definition at line 835 of file _character_customization.csc.

Referenced by update_character_animation_and_attachments().

update_character_extracam()

function update_character_extracam	(	localClientNum	,
		data_struct
	)

Definition at line 1391 of file _character_customization.csc.

References setup_character_extracam_settings().

Referenced by setup_static_character_customization_target().

update_locked_shader()

function update_locked_shader	(	localClientNum	,
		params
	)

Definition at line 1105 of file _character_customization.csc.

Referenced by updateEventThread().

update_model_attachment()

function update_model_attachment	(	localClientNum	,
		data_struct	,
		attached_model	,
		slot	,
		model_anim	,
		model_intro_anim	,
		force_update
	)

Definition at line 227 of file _character_customization.csc.

References play_intro_and_animation(), and Spawn().

Referenced by update(), and update_character_animation_and_attachments().

update_model_rotation_for_right_stick()

function update_model_rotation_for_right_stick	(	localClientNum	,
		data_struct	,
		endOnEvent
	)

Definition at line 1265 of file _character_customization.csc.

References IS_TRUE, RS_ROTATION_SPEED_MULTIPLIER, VAL, and WAIT_CLIENT_FRAME.

Referenced by rotation_thread_spawner().

update_show_helmets()

function update_show_helmets	(	localClientNum	,
		data_struct	,
		show_helmets
	)

Definition at line 1058 of file _character_customization.csc.

References update().

update_use_frozen_moments()

function update_use_frozen_moments	(	localClientNum	,
		data_struct	,
		useFrozenMoments
	)

Definition at line 1036 of file _character_customization.csc.

References get(), HERO_CUSTOMIZE_IDLE_ANIM, LIVE_CHARACTER_SPAWN_TARGET, and update_character_animation_and_attachments().

updateEventThread()

function updateEventThread	(	localClientNum	,
		data_struct
	)

Definition at line 1117 of file _character_customization.csc.

References get_character_body_colors(), get_character_helmet_colors(), HERO_CUSTOMIZE_IDLE_ANIM, is_character_streamed(), loadEquippedCharacterOnModel(), previewGesture(), previewTaunt(), set_body(), set_body_color(), set_head(), set_helmet(), set_helmet_color(), set_showcase_weapon(), update(), update_character_animation_and_attachments(), and update_locked_shader().

Referenced by setup_live_character_customization_target().

wait_for_extracam_close()

function wait_for_extracam_close	(	localClientNum	,
		camera_ent	,
		extraCamIndex
	)

Definition at line 1331 of file _character_customization.csc.

References extracam_reset_index().

Referenced by setup_character_extracam_settings().