Files
nunuhara_xsystem4/notes/parts-engine.md
T
2023-04-05 19:28:30 -07:00

34 KiB

PartsEngine

The PartsEngine library is Alicesoft's GUI library. This document tracks the changes in the interface to this library across games.

The biggest change happened between Drapeko and Rance IX. Rance 01, which was released between those two games, renamed the library to "GUIEngine" and also included substantial changes, but it is omitted here.

Ideally, all versions of the library should be implemented on top of the same backend in xsystem4.

Oyako Rankan -> Pastel Chime 3

Signature Changes

  • AddCopyCutCGToPartsConstructionProcess
  • AddDrawCutCGToPartsConstructionProcess
  • SetHGaugeRate
  • SetVGaugeRate
  • AddMotionHGaugeRate
  • AddMotionVGaugeRate

New Functions

  • AddDrawLineToPartsConstructionProcess
  • BackPartsFlatBeginFrame
  • ExistsFlatFile
  • GetPartsPassCursor
  • GoFramePartsFlat
  • IsPartsFlatEnd
  • SetPartsFlatAndStop
  • SetPartsFlat
  • StartPartsFlat
  • StepPartsFlat
  • StopPartsFlat
  • GetPartsFlatCurrentFrameNumber
  • GetPartsFlatEndFrame
  • SetPassCursor

Pastel Chime 3 -> Drapeko

Identical

Drapeko -> Rance 9

Signature Changes

  • Many functions are now prefixed with "Parts_"
  • Many functions have "Component" added to the name
  • Only a few argument changes (noted below)

Name Changes

"Parts_" prefix added, otherwise unchanged:

  • Parts_AddAddFilterToPartsConstructionProcess
  • Parts_AddCopyCutCGToPartsConstructionProcess
  • Parts_AddCopyTextToPartsConstructionProcess
  • Parts_AddCreateCGToProcess
  • Parts_AddCreatePixelOnlyToPartsConstructionProcess
  • Parts_AddCreateToPartsConstructionProcess
  • Parts_AddDrawCutCGToPartsConstructionProcess
  • Parts_AddDrawLineToPartsConstructionProcess
  • Parts_AddDrawRectToPartsConstructionProcess
  • Parts_AddDrawTextToPartsConstructionProcess
  • Parts_AddFillAlphaColorToPartsConstructionProcess
  • Parts_AddFillAMapToPartsConstructionProcess
  • Parts_AddFillGradationHorizonToPartsConstructionProcess
  • Parts_AddFillToPartsConstructionProcess
  • Parts_AddFillWithAlphaToPartsConstructionProcess
  • Parts_AddGrayFilterToPartsConstructionProcess
  • Parts_AddMulFilterToPartsConstructionProcess
  • Parts_AddPartsText
  • Parts_BackPartsFlatBeginFrame
  • Parts_BuildPartsConstructionProcess
  • Parts_ClearPartsConstructionProcess
  • Parts_DeletePartsTopTextLine
  • Parts_ExistsFlatFile
  • Parts_GetPartsClickable
  • Parts_GetPartsPassCursor
  • Parts_GetPartsTextCountReturn
  • Parts_GetResetTimerByChangeInputStatus
  • Parts_GoFramePartsFlat
  • Parts_IsCursorIn
  • Parts_IsPartsFlatEnd
  • Parts_SetFont
  • Parts_SetHGaugeCG
  • Parts_SetHGaugeRate
  • Parts_SetHGaugeSurfaceArea
  • Parts_SetLoopCG
  • Parts_SetLoopCGSurfaceArea
  • Parts_SetNumeralCG
  • Parts_SetNumeralFont
  • Parts_SetNumeralLength
  • Parts_SetNumeralLinkedCGNumberWidthWidthList
  • Parts_SetNumeralNumber
  • Parts_SetNumeralShowComma
  • Parts_SetNumeralSpace
  • Parts_SetNumeralSurfaceArea
  • Parts_SetPartsCGDetectionSize
  • Parts_SetPartsCGDetectionSurfaceArea
  • Parts_SetPartsCG
  • Parts_SetPartsCGSurfaceArea
  • Parts_SetPartsConstructionSurfaceArea
  • Parts_SetPartsFlatAndStop
  • Parts_SetPartsFlat
  • Parts_SetPartsFontBoldWeight
  • Parts_SetPartsFontColor
  • Parts_SetPartsFontEdgeColor
  • Parts_SetPartsFontEdgeWeight
  • Parts_SetPartsFontSize
  • Parts_SetPartsFontType
  • Parts_SetPartsRectangleDetectionSize
  • Parts_SetPartsRectangleDetectionSurfaceArea
  • Parts_SetPartsTextSurfaceArea
  • Parts_SetTextCharSpace
  • Parts_SetText
  • Parts_SetTextLineSpace
  • Parts_SetThumbnailMode
  • Parts_SetThumbnailReductionSize
  • Parts_SetVGaugeCG
  • Parts_SetVGaugeRate
  • Parts_SetVGaugeSurfaceArea
  • Parts_StartPartsFlat
  • Parts_StepPartsFlatFinalFrame
  • Parts_StopPartsFlat
  • Parts_GetPartsUpperLeftPosX
  • Parts_GetPartsUpperLeftPosY
  • Parts_GetInputState
  • Parts_GetPartsFlatCurrentFrameNumber
  • Parts_GetPartsFlatEndFrame
  • Parts_GetPartsHeight
  • Parts_GetPartsWidth
  • Parts_GetSoundNumber
  • Parts_AddPartsTextHighlight
  • Parts_ClearPartsTextHighlight
  • Parts_GetPartsCGName
  • Parts_SetClickable
  • Parts_SetInputState
  • Parts_SetOnCursorShowLinkPartsNumber
  • Parts_SetParentPartsNumber
  • Parts_SetPartsPixelDecide
  • Parts_SetPartsTextCountReturn
  • Parts_SetPartsTextHighlight
  • Parts_SetPassCursor
  • Parts_SetResetTimerByChangeInputStatus
  • Parts_SetSoundNumber

Functions with "Component" added:

  • AddMotionCG -> AddComponentMotionCG
  • GetPartsMessageWindowShowLink -> IsComponentMessageWindowShowLink
  • GetPartsShow -> IsComponentShow
  • GetPartsX -> GetComponentPosX
  • GetPartsY -> GetComponentPosY
  • GetPartsZ -> GetComponentPosZ
  • GetPartsAlpha -> GetComponentAlpha
  • GetPartsOriginPosMode -> GetComponentOriginPosMode
  • GetPartsSpeedupRateByMessageSkip -> GetComponentSpeedupRateByMessageSkip
  • AddMotionAlpha -> AddComponentMotionAlpha
  • AddMotionHGaugeRate -> AddComponentMotionHGaugeRate
  • AddMotionMagX -> AddComponentMotionMagX
  • AddMotionMagY -> AddComponentMotionMagY
  • AddMotionNumeralNumber -> AddComponentMotionNumeralNumber
  • AddMotionPos -> AddComponentMotionPos
  • AddMotionRotateX -> AddComponentMotionRotateX
  • AddMotionRotateY -> AddComponentMotionRotateY
  • AddMotionRotateZ -> AddComponentMotionRotateZ
  • AddMotionVGaugeRate -> AddComponentMotionVGaugeRate
  • AddMotionVibrationSize -> AddComponentMotionVibrationSize
  • SetAddColor -> SetComponentAddColor
  • SetPartsAlphaClipperPartsNumber -> SetComponentAlphaClipper
  • SetAlpha -> SetComponentAlpha
  • SetPartsDrawFilter -> SetComponentDrawFilter
  • SetPartsMagX -> SetComponentMagX
  • SetPartsMagY -> SetComponentMagY
  • SetPartsMessageWindowShowLink -> SetComponentMessageWindowShowLink
  • SetMultiplyColor -> SetComponentMulColor
  • SetPartsOriginPosMode -> SetComponentOriginPosMode
  • SetPos -> SetComponentPos
    • argument types also change
  • SetZ -> SetComponentPosZ
  • SetPartsRotateX -> SetComponentRotateX
  • SetPartsRotateY -> SetComponentRotateY
  • SetPartsRotateZ -> SetComponentRotateZ
  • SetShow -> SetComponentShow
  • SetSpeedupRateByMessageSkip -> SetComponentSpeedupRateByMessageSkip
  • Update -> UpdateComponent

Other:

  • IsExistParts -> IsExist
  • GetClickPartsNumber -> GetClickNumber
  • GetFreeSystemPartsNumber -> GetFreeNumber
  • ReleaseAllParts -> ReleaseAll
    • arguments also change
  • ReleaseAllPartsWithoutSystem -> ReleaseAllWithoutSystem
    • arguments also change
  • ReleaseParts -> Release
  • SetFocusPartsNumber -> SetFocus

New Functions

  • AddComponentMotionCGTerination
  • CrateActivityBinary
  • GetMessageVariableBool
  • IsButtonDrag
  • IsButtonEnable
  • IsButtonPixelDecide
  • IsCheckBoxChecked
  • IsCheckBoxDrag
  • IsComponentMipmap
  • IsFocus
  • IsLayoutBoxReturn
  • LoadParts
  • Parts_CreateParts3DLayerPluginID
  • Parts_GetPartsDrag
  • Parts_IsPartsPixelDecide
  • Parts_ReleaseParts3DLayerPluginID
  • Parts_SetPartsFlatSurfaceArea
  • ReadActivityBinary
  • ReleaseActivity
  • SaveParts
  • GetComponentMagX
  • GetComponentMagY
  • GetComponentRotateX
  • GetComponentRotateY
  • GetComponentRotateZ
  • GetHScrollbarScrollRate
  • GetMessageVariableFloat
  • GetVScrollbarScrollRate
  • AddController
  • GetButtonB
  • GetButtonClickSoundNumber
  • GetButtonG
  • GetButtonOnCursorSoundNumber
  • GetButtonR
  • GetCheckBoxB
  • GetCheckBoxClickSoundNumber
  • GetCheckBoxG
  • GetCheckBoxOnCursorSoundNumber
  • GetCheckBoxR
  • GetComboBoxTextHeightMargin
  • GetComboBoxTextWidthMargin
  • GetComponentAddColorB
  • GetComponentAddColorG
  • GetComponentAddColorR
  • GetComponentAlphaClipper
  • GetComponentDrawFilter
  • GetComponentHeight
  • GetComponentMarginBottom
  • GetComponentMarginLeft
  • GetComponentMarginRight
  • GetComponentMarginTop
  • GetComponentMulColorB
  • GetComponentMulColorG
  • GetComponentMulColorR
  • GetComponentTextureFilterType
  • GetComponentType
  • GetComponentWidth
  • GetDelegateIndex
  • GetHScrollbarClickSoundNumber
  • GetHScrollbarLeftWidth
  • GetHScrollbarMoveSizeByButton
  • GetHScrollbarOnCursorSoundNumber
  • GetHScrollbarRightWidth
  • GetHScrollbarScrollPos
  • GetHScrollbarTotalSize
  • GetHScrollbarViewSize
  • GetLayoutBoxAlign
  • GetLayoutBoxLayoutType
  • GetLayoutBoxReturnSize
  • GetListBoxHeightMargin
  • GetListBoxItemCount
  • GetListBoxLineHeight
  • GetListBoxOnCursorItemIndex
  • GetListBoxScrollPos
  • GetListBoxSelectIndex
  • GetListBoxWidthMargin
  • GetMessageDelegateIndex
  • GetMessageDelegateIndex
  • GetMessagePartsNumber
  • GetMessageType
  • GetMessageVariableCount
  • GetMessageVariableInt
  • GetMessageVariableType
  • GetMultiTextBoxMaxTextLength
  • GetMultiTextBoxSelectB
  • GetMultiTextBoxSelectG
  • GetMultiTextBoxSelectR
  • GetTextBoxMaxTextLength
  • GetTextBoxSelectB
  • GetTextBoxSelectG
  • GetTextBoxSelectR
  • GetVScrollbarClickSoundNumber
  • GetVScrollbarDownHeight
  • GetVScrollbarMoveSizeByButton
  • GetVScrollbarOnCursorSoundNumber
  • GetVScrollbarScrollPos
  • GetVScrollbarTotalSize
  • GetVScrollbarUpHeight
  • GetVScrollbarViewSize
  • PartsFunc
  • Parts_GetOnCursorShowLinkPartsNumber
  • Parts_GetParentPartsNumber
  • Parts_GetParts3DLayerPluginID
  • AddListBoxItem
  • CheckBoxChecked
  • ClearListBoxItem
  • CloseTextBoxIME
  • EraseListBoxItem
  • GetButtonCGName
  • GetButtonFontProperty
  • GetButtonText
  • GetCheckBoxCGName
  • GetCheckBoxFontProperty
  • GetCheckBoxText
  • GetComboBoxCGName
  • GetComboBoxFontProperty
  • GetComboBoxText
  • GetHScrollbarCGName
  • GetListBoxCGName
  • GetListBoxFontProperty
  • GetListBoxItem
  • GetListBoxOnCursorItem
  • GetMessageVariableString
  • GetMultiTextBoxCGName
  • GetMultiTextBoxFontProperty
  • GetMultiTextBoxText
  • GetTextBoxCGName
  • GetTextBoxFontProperty
  • GetTextBoxText
  • GetVScrollbarCGName
  • InsertListBoxItem
  • OpenTextBoxIME
  • Parts_ChangeFlatCG
  • Parts_ChangeFlatSound
  • Parts_GetPartsFlatDataInfo
  • Parts_SetDrag
  • PopMessage
  • ReleaseMessage
  • RemoveController
  • ResumeBuildView
  • SetButtonCGName
  • SetButtonClickSoundNumber
  • SetButtonColor
  • SetButtonDrag
  • SetButtonEnable
  • SetButtonFontProperty
  • SetButtonOnCursorSoundNumber
  • SetButtonPixelDecide
  • SetButtonSize
  • SetButtonText
  • SetCheckBoxCGName
  • SetCheckBoxClickSoundNumber
  • SetCheckBoxColor
  • SetCheckBoxDrag
  • SetCheckBoxFontProperty
  • SetCheckBoxOnCursorSoundNumber
  • SetCheckBoxSize
  • SetCheckBoxText
  • SetComboBoxCGName
  • SetComboBoxFontProperty
  • SetComboBoxSize
  • SetComboBoxText
  • SetComboBoxTextMargin
  • SetComponentMargin
  • SetComponentMipmap
  • SetComponentTextureFilterType
  • SetComponentType
  • SetDelegateIndex
  • SetHScrollbarCGName
  • SetHScrollbarClickSoundNumber
  • SetHScrollbarLeftWidth
  • SetHScrollbarMoveSizeByButton
  • SetHScrollbarOnCursorSoundNumber
  • SetHScrollbarRightWidth
  • SetHScrollbarScrollPos
  • SetHScrollbarScrollRate
  • SetHScrollbarSize
  • SetHScrollbarTotalSize
  • SetHScrollbarViewSize
  • SetLayoutBoxAlign
  • SetLayoutBoxLayoutType
  • SetLayoutBoxReturn
  • SetListBoxCGName
  • SetListBoxFontProperty
  • SetListBoxItem
  • SetListBoxLineHeight
  • SetListBoxMargin
  • SetListBoxScrollPos
  • SetListBoxSelectIndex
  • SetListBoxSize
  • SetMultiTextBoxCGName
  • SetMultiTextBoxFontProperty
  • SetMultiTextBoxMaxTextLength
  • SetMultiTextBoxSelectColor
  • SetMultiTextBoxSize
  • SetMultiTextBoxText
  • SetTextBoxCGName
  • SetTextBoxFontProperty
  • SetTextBoxMaxTextLength
  • SetTextBoxSelectColor
  • SetTextBoxSize
  • SetTextBoxText
  • SetVScrollbarCGName
  • SetVScrollbarClickSoundNumber
  • SetVScrollbarDownHeight
  • SetVScrollbarMoveSizeByButton
  • SetVScrollbarOnCursorSoundNumber
  • SetVScrollbarScrollPos
  • SetVScrollbarScrollRate
  • SetVScrollbarSize
  • SetVScrollbarTotalSize
  • SetVScrollbarUpHeight
  • SetVScrollbarViewSize
  • StopSoundWithoutSystemSound
  • SuspendBuildViewAt
  • SuspendBuildView

Removed Functions

BackPartsFlashBeginFrame ExistsFlashFile GoFramePartsFlash Init IsPartsFlashEnd SetPartsFlashAndStop SetPartsFlash SetPartsFlashSurfaceArea SetPartsGroupNumber StartPartsFlash StepPartsFlashFinalFrame StopPartsFlash GetFocusPartsNumber GetFreeSystemPartsNumberNotSaved GetPartsFlashCurrentFrameNumber GetPartsFlashEndFrame GetAddColor GetMultiplyColor PopGUIController PushGUIController SetPartsGroupDecideClick SetPartsGroupDecideOnCursor UpdateGUIController

Rance IX -> Blade Briders

Identical

Blade Briders -> Evenicle

Signature Changes

  • AddMotionSound
  • Parts_ChangeFlatSound
  • SetLayoutBoxReturn

New Functions

  • IsLayoutBoxReturnSizeForRate
  • IsMultiTextBoxReadOnly
  • IsOpenTextBoxIME
  • LoadBackScene
  • Parts_IsPosForRate
  • Parts_IsTextEnableTag
  • SaveBackScene
  • GetLayoutBoxReturnSize
  • GetActiveParts
  • GetMultiTextBoxBGB
  • GetMultiTextBoxBGG
  • GetMultiTextBoxBGR
  • GetMultiTextBoxFrameB
  • GetMultiTextBoxFrameG
  • GetMultiTextBoxFrameR
  • GetMultiTextBoxReadOnlyBGB
  • GetMultiTextBoxReadOnlyBGG
  • GetMultiTextBoxReadOnlyBGR
  • GetTextBoxBGB
  • GetTextBoxBGG
  • GetTextBoxBGR
  • GetTextBoxFrameB
  • GetTextBoxFrameG
  • GetTextBoxFrameR
  • GetTextBoxReadOnlyB
  • GetTextBoxReadOnlyG
  • GetTextBoxReadOnlyR
  • Parts_GetRubyCharSpace
  • Parts_GetTextPos
  • Parts_GetTextShowTime
  • AddComponentMotionAddColor
  • AddComponentMotionMulColor
  • ClearBackScene
  • GetButtonFlatName
  • GetCheckBoxFlatName
  • GetClickMissSoundName
  • GetHScrollbarFlatName
  • GetVScrollbarFlatName
  • Parts_GetRubyFont
  • Parts_GetSoundName
  • Parts_JumpFlatLabel
  • Parts_PlaySound
  • Parts_SetPosForRate
  • Parts_SetRubyCharSpace
  • Parts_SetRubyFont
  • Parts_SetSoundName
  • Parts_SetTextEnableTag
  • Parts_SetTextPos
  • Parts_SetTextShowTime
  • SetAlphaForBackScene
  • SetButtonFlatName
  • SetCheckBoxFlatName
  • SetClickMissSoundName
  • SetFontColorForBackscene
  • SetHScrollbarFlatName
  • SetLayoutBoxReturnSizeForRate
  • SetMulColorForBackScene
  • SetMultiTextBoxBGColor
  • SetMultiTextBoxFrameColor
  • SetMultiTextBoxReadOnlyBGColor
  • SetMultiTextBoxReadOnly
  • SetOpenTextBoxIME
  • SetShowForBackScene
  • SetTextBoxBGColor
  • SetTextBoxFrameColor
  • SetTextBoxReadOnlyBGColor
  • SetVScrollbarFlatName

Removed Functions

  • IsButtonDrag
  • IsButtonPixelDecide
  • IsCheckBoxDrag
  • Parts_SetThumbnailMode
  • Parts_SetThumbnailReductionSize
  • SaveWithoutHideParts
  • GetButtonClickSoundNumber
  • GetButtonOnCursorSoundNumber
  • GetCheckBoxClickSoundNumber
  • GetCheckBoxOnCursorSoundNumber
  • GetClickMissSoundNumber
  • GetHScrollbarClickSoundNumber
  • GetHScrollbarOnCursorSoundNumber
  • GetLayoutBoxReturnSize
  • GetVScrollBarClickSoundNumber
  • GetVScrollbarOnCursorSoundNumber
  • Parts_GetSoundNumber
  • CloseTextBoxIME
  • OpenTextBoxIME
  • Parts_SetSoundNumber
  • ReleaseAll
  • SetButtonClickSoundNumber
  • SetButtonDrag
  • SetButtonOnCursorSoundNumber
  • SetButtonPixelDecide
  • SetCheckBoxClickSoundNumber
  • SetCheckBoxDrag
  • SetCheckBoxOnCursorSoundNumber
  • SetClickMissSoundNumber
  • SetHScrollbarClickSoundNumber
  • SetHScrollbarOnCursorSoundNumber
  • SetVScrollbarClickSoundNumber
  • SetVScrollbarOnCursorSoundNumber

Evenicle -> Rance 03

Signature Changes

None.

New Functions

  • AddActivityParts
  • CreateActivity
  • CreatePartsMovie
  • GetActivityParts
  • IsCheckBoxButtonMode
  • IsEndPartsMovie
  • IsExistActivityCloseParts
  • IsExistActivityEndKey
  • IsExistActivityFile
  • IsExistActivityIntentData
  • IsExistActivityPartsByName
  • IsExistActivityPartsByNumber
  • IsExistActivity
  • IsExistChild
  • IsLockInputState
  • IsNumeralShowPadding
  • IsNumerarlFullPitch (sic)
  • IsRadioButtonBoxExistGUI
  • IsTextBoxReadOnly
  • IsWantSaveBackScene
  • LoadActivityEXText
  • Parts_IsNumeralShow
  • Parts_IsPartsFlatStop
  • PlayPartsMovie
  • ReadActivityFile
  • ReleasePartsMovie
  • RemoveActivityParts
  • RemoveAllActivityParts
  • SaveActivityEXText
  • SaveThumbnail
  • WriteActivityFile
  • GetComponentAbsolutePosX
  • GetComponentAbsolutePosY
  • GetFlatFPSRate
  • Parts_GetHGaugeDenominator
  • Parts_GetHGaugeNumerator
  • Parts_GetVGaugeDenominator
  • Parts_GetVGaugeNumerator
  • GetActiveController
  • GetActivityEndKey
  • GetActivityIntentDataType
  • GetActivityPartsNumber
  • GetButtonCharSpace
  • GetButtonLineSpace
  • GetButtonTextOriginPosMode
  • GetCheckBoxButtonHeight
  • GetCheckBoxButtonWidth
  • GetCheckBoxCharSpace
  • GetCheckBoxLineSpace
  • GetCheckBoxTextOriginPosMode
  • GetChildIndex
  • GetChild
  • GetComboBoxCharSpace
  • GetComponentAbsoluteMaxPosZ
  • GetComponentAbsolutePosZ
  • GetComponentCheckBoxShowLinkNumber
  • GetComponentScrollAlphaLinkNumber
  • GetComponentScrollPosXLinkNumber
  • GetComponentScrollPosYLinkNumber
  • GetControllerID
  • GetControllerIndex
  • GetControllerLength
  • GetFlatFPS
  • GetLayoutBoxPaddingBottom
  • GetLayoutBoxPaddingLeft
  • GetLayoutBoxPaddingRight
  • GetLayoutBoxPaddingTop
  • GetListBoxCharSpace
  • GetLoopCGNumofCG
  • GetLoopCGStartNo
  • GetMultiTextBoxCharSpace
  • GetMultiTextBoxLineSpace
  • GetNumeralLength
  • GetRadioButtonBoxChild
  • GetSystemOverlayController
  • GetTextBoxCharSpace
  • NumofActivityEndKey
  • NumofActivityIntentDataDestination
  • NumofActivityParts
  • NumofChild
  • NumofFlatCG
  • NumofFlatSound
  • NumofRadioButtonBoxChild
  • Parts_GetLoopCGTimeParCG
  • Parts_GetNumeralCGType
  • Parts_GetNumeralNumber
  • Parts_GetNumeralSpace
  • Parts_GetPartsCGDeform
  • Parts_GetPartsConstructionProcessCount
  • Parts_GetTextCharSpace
  • Parts_GetTextLineSpace
  • AddActivityCloseParts
  • AddActivityIntentDataDestination
  • AddChild
  • AddPartsConstructionProcess
  • AddRadioButtonBoxChild
  • ClearChangeFlatCG
  • ClearChangeFlatSound
  • ClearChild
  • ClearRadioButtonBoxChild
  • EraseActivityEndKey
  • GetActivityIntentDataDestination
  • GetActivityPartsName
  • GetCGDetectionSurfaceArea
  • GetComponentAbsolutePos
  • GetConstructionSurfaceArea
  • GetFlatCGName
  • GetFlatSoundName
  • GetFlatSurfaceArea
  • GetHGaugeSurfaceArea
  • GetLoopCGCGName
  • GetLoopCGSurfaceArea
  • GetNumeralCGNumberWidthList
  • GetNumeralFont
  • GetNumeralSurfaceArea
  • GetPartsCGSurfaceArea
  • GetPartsConstructionProcess
  • GetPartsTextFontProperty
  • GetPartsTextSurfaceArea
  • GetProxyFlatCGName
  • GetProxyFlatSound
  • GetRectangleDetectionPoint
  • GetRectangleDetectionSurfaceArea
  • GetTextPartsText
  • GetVGaugeSurfaceArea
  • InsertChild
  • Parts_GetHGaugeCG
  • Parts_GetNumeralCGName
  • Parts_GetPartsCGDetectionCGName
  • Parts_GetPartsFlatName
  • Parts_GetVGaugeCG
  • PauseMotion
  • RemoveActivityCloseParts
  • RemoveAllActivityCloseParts
  • RemoveChild
  • RemoveRadioButtonBoxChild
  • ReturnChangeFlatCG
  • ReturnChangeFlatSound
  • SelectTextBoxAll
  • SetActiveController
  • SetActivityEndKey
  • SetActivityIntentData
  • SetButtonCharSpace
  • SetButtonLineSpace
  • SetButtonTextOriginPosMode
  • SetCheckBoxButtonMode
  • SetCheckBoxCharSpace
  • SetCheckBoxLineSpace
  • SetCheckBoxTextOriginPosMode
  • SetComboBoxCharSpace
  • SetComponentCheckBoxShowLinkNumber
  • SetComponentScrollAlphaLinkNumber
  • SetComponentScrollPosXLinkNumber
  • SetComponentScrollPosYLinkNumber
  • SetFlatFPSRate
  • SetLayoutBoxPadding
  • SetListBoxCharSpace
  • SetLockInputState
  • SetMultiTextBoxCharSpace
  • SetMultiTextBoxLineSpace
  • SetNumeralFont
  • SetNumeralFullPitch
  • SetNumeralShowPadding
  • SetNumeralShowType
  • SetRectangleDetectionPoint
  • SetTextBoxCharSpace
  • SetTextBoxReadOnly
  • SetWantSaveBackScene

Removed Functions

  • CrateActivityBinary
  • Parts_SetNumeralFont
  • ReadActivityBinary
  • PartsFunc

Rance 03 -> Tsumamigui 3

Signature Changes

None.

New Functions

  • GetActivityEXID
  • GetMultiTextBoxPaddingBottom
  • GetMultiTextBoxPaddingLeft
  • GetMultiTextBoxPaddingRight
  • GetMultiTextBoxPaddingTop
  • Parts_GetSwipeType
  • GetActivityEXText
  • Parts_SetSwipeType
  • Parts_StopSwipe
  • SetActivityEXText
  • SetMultiTextBoxPadding
  • UpdateMatrix

Removed Functions

  • Parts_AddAddFilterToPartsConstructionProcess
  • Parts_AddCopyCutCGToPartsConstructionProcess
  • Parts_AddCopyTextToPartsConstructionProcess
  • Parts_AddCreateCGToProcess
  • Parts_AddCreatePixelOnlyToPartsConstructionProcess
  • Parts_AddCreateToPartsConstructionProcess
  • Parts_AddDrawCutCGToPartsConstructionProcess
  • Parts_AddDrawLineToPartsConstructionProcess
  • Parts_AddDrawRectToPartsConstructionProcess
  • Parts_AddDrawTextToPartsConstructionProcess
  • Parts_AddFillAlphaColorToPartsConstructionProcess
  • Parts_AddFillAMapToPartsConstructionProcess
  • Parts_AddFillGradationHorizonToPartsConstructionProcess
  • Parts_AddFillToPartsConstructionProcess
  • Parts_AddFillWithAlphaToPartsConstructionProcess
  • Parts_AddGrayFilterToPartsConstructionProcess
  • Parts_AddMulFilterToPartsConstructionProcess

Tsumamigui 3 -> Heartful Maman

Signature Changes

  • GetComponentAbsolutePos -> GetComponentAbsoluteSquarePos
    • Simplified version of GetComponentAbsolutePos still exists
  • UpdateComponent
    • More arguments
  • UpdateMatrix
    • More arguments

New Functions

  • BackMessageWindowFlatBeginFrame
  • GetComponentReverseLR
  • GetComponentReverseTB
  • IsCheckBoxEnable
  • IsComponentMessageWindowEffectLink
  • IsFixedMessageWindowText
  • IsKeyWaitShow
  • IsMultiTextBoxHScrollShow
  • IsMultiTextBoxVScrollShow
  • IsOverMessageWindowFlatShowWaitFrame
  • IsSpinBoxReadOnly
  • Parts_IsAnchorBottom
  • Parts_IsAnchorLeft
  • Parts_IsAnchorRight
  • Parts_IsAnchorTop
  • Parts_IsFixedText
  • Parts_IsLockUpdate
  • StepMessageWindowFlatFinalFrame
  • GetSpinBoxDefaultValue
  • GetSpinBoxIncrementalValue
  • GetSpinBoxMaxValue
  • GetSpinBoxMinValue
  • GetSpinBoxValue
  • GetFormCaptionB
  • GetFormCaptionG
  • GetFormCaptionR
  • GetHScrollTotalSizeLinkNumber
  • GetHScrollViewSizeLinkNumber
  • GetKeyWaitPosX
  • GetKeyWaitPosY
  • GetKeyWaitPosZ
  • GetMessageWindowFlatShowWaitFrameNumber
  • GetMessageWindowInactiveMultipleColorB
  • GetMessageWindowInactiveMultipleColorG
  • GetMessageWindowInactiveMultipleColorR
  • GetMessageWindowTextOriginPosMode
  • GetMessageWindowTextSpeed
  • GetMotionBeginFrame
  • GetMotionEndFrame
  • GetPanelA
  • GetPanelAlphaGradationBottom
  • GetPanelAlphaGradationLeft
  • GetPanelAlphaGradationRight
  • GetPanelAlphaGradationTop
  • GetPanelB
  • GetPanelG
  • GetPanelR
  • GetSpinBoxBGB
  • GetSpinBoxBGG
  • GetSpinBoxBGR
  • GetSpinBoxCharSpace
  • GetSpinBoxDecimalPlace
  • GetSpinBoxFrameB
  • GetSpinBoxFrameG
  • GetSpinBoxFrameR
  • GetSpinBoxReadOnlyBGB
  • GetSpinBoxReadOnlyBGG
  • GetSpinBoxReadOnlyBGR
  • GetSpinBoxSelectB
  • GetSpinBoxSelectG
  • GetSpinBoxSelectR
  • GetVScrollTotalSizeLinkNumber
  • GetVScrollViewSizeLinkNumber
  • GetActivityEXText
  • GetActivityIntentDataDestination
  • GetActivityPartsName
  • GetButtonCGName
  • GetButtonFlatName
  • GetButtonText
  • GetCheckBoxCGName
  • GetCheckBoxFlatName
  • GetCheckBoxText
  • GetClickMissSoundName
  • GetComboBoxCGName
  • GetComboBoxText
  • GetFlatCGName
  • GetFlatSoundName
  • GetFormIcon
  • GetFormTitle
  • GetHScrollbarCGName
  • GetHScrollbarFlatName
  • GetKeyWaitFlatName
  • GetListBoxCGName
  • GetListBoxItem
  • GetListBoxOnCursorItem
  • GetLoopCGCGName
  • GetMessageVariableString
  • GetMessageWindowCGName
  • GetMessageWindowFlatName
  • GetMessageWindowText
  • GetMultiTextBoxCGName
  • GetMultiTextBoxText
  • GetProxyFlatCGName
  • GetProxyFlatSound
  • GetSpinBoxCGName
  • GetTextBoxCGName
  • GetTextBoxText
  • GetTextPartsText
  • GetVScrollbarCGName
  • GetVScrollbarFlatName
  • Parts_GetHGaugeCG
  • Parts_GetNumeralCGName
  • Parts_GetPartsCGDetectionCGName
  • Parts_GetPartsCGName
  • Parts_GetPartsFlatDataInfo
  • Parts_GetPartsFlatName
  • Parts_GetSoundName
  • Parts_GetVGaugeCG
  • AddListBoxItem
  • FixMessageWindowText
  • FormClose
  • GetKeyWaitCGName
  • GetMessageWindowTextArea
  • GetMessageWindowTextFont
  • GetMessageWindowTextSpace
  • GetSpinBoxFontProperty
  • MoveController
  • Parts_FixText
  • Parts\GetPartsSize
  • Parts_GetPartsUpperLeftPos
  • Parts_JumpFlatLabel
  • Parts_SetAnchor
  • Parts_SetLockUpdate
  • Parts_SetUpdateLookAtPos
  • SelectSpinBoxAll
  • SetCheckBoxEnable
  • SetComponentMessageWindowEffectLink
  • SetComponentReverseLR
  • SetComponentReverseTB
  • SetComponentVibrationPos
  • SetFormCaptionColor
  • SetFormIcon
  • SetFormSize
  • SetFormTitle
  • SetHScrollbarCGName
  • SetHScrollbarFlatName
  • SetHScrollTotalSizeLinkNumber
  • SetHScrollViewSizeLinkNumber
  • SetKeyWaitCGName
  • SetKeyWaitFlatName
  • SetKeyWaitPos
  • SetKeyWaitShow
  • SetMessageWindowActive
  • SetMessageWindowCGName
  • SetMessageWindowFlatName
  • SetMessageWindowFlatShowWaitFrameNumber
  • SetMessageWindowInactiveMultipleColor
  • SetMessageWindowTextArea
  • SetMessageWindowTextFont
  • SetMessageWindowText
  • SetMessageWindowTextOriginPosMode
  • SetMessageWindowTextSpace
  • SetMessageWindowTextSpeed
  • SetMotionData
  • SetMultiTextBoxHScrollShow
  • SetMultiTextBoxVScrollShow
  • SetPanelAlphaGradationBottom
  • SetPanelAlphaGradationLeft
  • SetPanelAlphaGradationRight
  • SetPanelAlphaGradationTop
  • SetPanelColor
  • SetPanelSize
  • SetSpinBoxBGColor
  • SetSpinBoxCGName
  • SetSpinBoxCharSpace
  • SetSpinBoxDecimalPlace
  • SetSpinBoxDefaultValue
  • SetSpinBoxFontProperty
  • SetSpinBoxFrameColor
  • SetSpinBoxIncrementalValue
  • SetSpinBoxMaxValue
  • SetSpinBoxMinValue
  • SetSpinBoxReadOnlyBGColor
  • SetSpinBoxReadOnly
  • SetSpinBoxSelectColor
  • SetSpinBoxSize
  • SetSpinBoxValue void SetVScrollTotalSizeLinkNumber(int Number, int LinkPartsNumber); void SetVScrollViewSizeLinkNumber(int Number, int LinkPartsNumber);

Removed Functions

  • AddComponentMotionCG
  • AddComponentMotionCGTermination
  • GetComponentHeight
  • GetComponentWidth
  • AddComponentMotionAddColor
  • AddComponentMotionAlpha
  • AddComponentMotionHGaugeRate
  • AddComponentMotionMagX
  • AddComponentMotionMagY
  • AddComponentMotionMulColor
  • AddComponentMotionNumeralNumber
  • AddComponentMotionPos
  • AddComponentMotionRotateX
  • AddComponentMotionRotateY
  • AddComponentMotionRotateZ
  • AddComponentMotionVGaugeRate
  • AddComponentMotionVibrationSize
  • AddListBoxItem
  • AddMotionSound
  • AddWholeMotionVibrationSize
  • BeginMotion
  • EndMotion
  • GetActivityEXText
  • GetActivityIntentDataDestination
  • GetActivityPartsName
  • GetButtonCGName
  • GetButtonFlatName
  • GetButtonText
  • GetCheckBoxCGName
  • GetCheckBoxFlatName
  • GetCheckBoxText
  • GetClickMissSoundName
  • GetComboBoxCGName
  • GetComboBoxText
  • GetFlatCGName
  • GetFlatSoundName
  • GetHScrollbarCGName
  • GetHScrollbarFlatName
  • GetListBoxCGName
  • GetListBoxItem
  • GetListBoxOnCursorItem
  • GetLoopCGCGName
  • GetMessageVariableString
  • GetMultiTextBoxCGName
  • GetMultiTextBoxText
  • GetProxyFlatCGName
  • GetProxyFlatSound
  • GetTextBoxCGName
  • GetTextBoxText
  • GetTextPartsText
  • GetVScrollbarCGName
  • GetVScrollbarFlatName
  • Parts_GetHGaugeCG
  • Parts_GetNumeralCGName
  • Parts_GetPartsCGDetectionCGName
  • Parts_GetPartsCGName
  • Parts_GetPartsFlatDataInfo
  • Parts_GetPartsFlatName
  • Parts_GetSoundName
  • Parts_GetVGaugeCG
  • Parts_JumpFlatLabel
  • PauseMotion
  • ResumeBuildView
  • SeekEndMotion
  • SetAlphaForBackScene
  • SetHScrollbarCGName
  • SetHScrollbarFlatName
  • SetMulColorForBackScene
  • SuspendBuildViewAt
  • SuspendBuildView
  • UpdateMotionTime

Heartful Maman -> Ixseal

Signature Changes

  • LoadActivityEXText
  • ReadActivityFile

These functions use the new ain v11 array type, but are otherwise unchanged:

  • LoadBackScene
  • LoadParts
  • Load
  • SaveBackScene
  • SaveParts
  • Save
  • AddPartsConstructionProcess
  • GetPartsConstructionProcess
  • ReleaseAllWithoutSystem
  • RemoveController

New Functions

  • IsComponentEnableClipArea
  • IsComponentShowEditor
  • IsExistActivityLockedParts
  • IsExistWorkerThread
  • IsFormEnableCloseButton
  • IsFormFold
  • IsFormResizable
  • Parts_BuildPartsConstructionProcessThread
  • Parts_IsFlatEnableLayer
  • Parts_IsThreadLoading
  • Parts_SetPartsCGThread
  • Parts_SetPartsFlatThread
  • GetComboBoxListBoxCharSpace
  • GetComboBoxListBoxHeight
  • GetComboBoxListBoxHeightMargin
  • GetComboBoxListBoxItemCount
  • GetComboBoxListBoxLineHeight
  • GetComboBoxListBoxScrollPos
  • GetComboBoxListBoxSelectIndex
  • GetComboBoxListBoxWidthMargin
  • GetComponentClipAreaPosHeight
  • GetComponentClipAreaPosWidth
  • GetComponentClipAreaPosX
  • GetComponentClipAreaPosY
  • GetComponentTextureAddressType
  • GetFlatGameViewHeight
  • GetFlatGameViewWidth
  • GetFormCaptionPlusHeight
  • GetFormClientB
  • GetFormClientG
  • GetFormClientR
  • GetFormGroupFormNumber
  • GetFormHScrollPos
  • GetFormHScrollTotalSize
  • GetFormHScrollViewSize
  • GetFormMaxHeight
  • GetFormMaxWidth
  • GetFormMinHeight
  • GetFormMinWidth
  • GetFormVScrollPos
  • GetFormVScrollTotalSize
  • GetFormVScrollViewSize
  • NumofFormGroupForm
  • NumofFormGroupTable
  • NumofFormGroupVList
  • Parts_GetFlatFrame
  • GetActivityBG
  • GetComboBoxListBoxItem
  • GetUserComponentData
  • GetUserComponentName
  • Parts_GetComment
  • AddActivityLockedParts
  • AddComboBoxListBoxItem
  • AddFormGroupFormNumber
  • AddFormGroupTable
  • AddFormGroupVList
  • ClearComboBoxListBoxItem
  • Debug_GetSpriteRect
  • EraseComboBoxListBoxItem
  • GetComboBoxListBoxFontProperty
  • GetFormGroupViewSnap
  • InsertComboBoxListBoxItem
  • Parts_SetComment
  • Parts_SetFlatEnableLayer
  • Parts_SetWheelable
  • SetActivityBG
  • SetComboBoxListBoxCharSpace
  • SetComboBoxListBoxFontProperty
  • SetComboBoxListBoxHeight
  • SetComboBoxListBoxItem
  • SetComboBoxListBoxLineHeight
  • SetComboBoxListBoxMargin
  • SetComboBoxListBoxScrollPos
  • SetComboBoxListBoxSelectIndex
  • SetComponentClipArea
  • SetComponentEnableClipArea
  • SetComponentShowEditor
  • SetComponentTextureAddressType
  • SetFormCaptionPlusHeight
  • SetFormClientColor
  • SetFormEnableCloseButton
  • SetFormFold
  • SetFormGroupViewSpan
  • SetFormHScrollPos
  • SetFormMaxSize
  • SetFormMinSize
  • SetFormResizable
  • SetFormVScrollPos
  • SetUserComponentData
  • SetUserComponentName

Removed Functions

  • RemoveActivityCloseParts
  • RemoveAllActivityCloseParts

Ixseal -> Rance X

Signature Changes

  • PlayPartsMovie
  • AddPartsConstructionProcess
  • GetPartsConstructionProcess
  • UpdateComponent

New Functions

  • IsComboBoxOpenListBox
  • IsEnableInputProcess
  • IsEnableSpeedUp
  • Parts_IsHGaugeReverse
  • Parts_IsVGaugeReverse
  • CreateUserPartsNumber
  • GetPartsMovieCurrentTime
  • GetPartsMovieEndTime
  • Parts_GetFlatBeginSeekFrame
  • GetCheckBoxOverrideCGName
  • GetCheckBoxOverrideCheckedCGName
  • GetCheckBoxOverrideCheckedFlatName
  • GetCheckBoxOverrideFlatName
  • GetHScrollbarOverrideBarCGName
  • GetHScrollbarOverrideBarFlatName
  • GetHScrollbarOverrideBGCGName
  • GetHScrollbarOverrideBGFlatName
  • GetHScrollbarOverrideLeftCGName
  • GetHScrollbarOverrideLeftFlatName
  • GetHScrollbarOverrideRightCGName
  • GetHScrollbarOverrideRightFlatName
  • GetVScrollbarOverrideBarCGName
  • GetVScrollbarOverrideBarFlatName
  • GetVScrollbarOverrideBGCGName
  • GetVScrollbarOverrideBGFlatName
  • GetVScrollbarOverrideDownCGName
  • GetVScrollbarOverrideDownFlatName
  • GetVScrollbarOverrideUpCGName
  • GetVScrollbarOverrideUpFlatName
  • Parts_SetFlatBeginSeekFrame
  • Parts_SetHGaugeReverse
  • Parts_SetVGaugeReverse
  • ReleaseUserPartsNumber
  • ResumeTexture
  • SetCheckBoxOverrideCGName
  • SetCheckBoxOverrideCheckedCGName
  • SetCheckBoxOverrideCheckedFlatName
  • SetCheckBoxOverrideFlatName
  • SetEnableInputProcess
  • SetEnableSpeedUp
  • SetHScrollbarOverrideBarCGName
  • SetHScrollbarOverrideBarFlatName
  • SetHScrollbarOverrideBGCGName
  • SetHScrollbarOverrideBGFlatName
  • SetHScrollbarOverrideLeftCGName
  • SetHScrollbarOverrideLeftFlatName
  • SetHScrollbarOverrideRightCGName
  • SetHScrollbarOverrideRightFlatName
  • SetMovieTime
  • SetVScrollbarOverrideBarCGName
  • SetVScrollbarOverrideBarFlatName
  • SetVScrollbarOverrideBGCGName
  • SetVScrollbarOverrideBGFlatName
  • SetVScrollbarOverrideDownCGName
  • SetVScrollbarOverrideDownFlatName
  • SetVScrollbarOverrideUpCGName
  • SetVScrollbarOverrideUpFlatName
  • SuspendTexture

Removed Functions

  • IsExistActivityIntentData
  • Parts_GetResetTimerByChangeInputStatus
  • GetActivityIntentDataType
  • GetComponentSpeedupRateByMessageSkip
  • NumofActivityIntentDataDestination
  • GetActivityIntentDataDestination
  • AddActivityIntentDataDestination
  • Parts_SetResetTimerByChangeInputStatus
  • ReleaseAllWithoutSystem
  • SetActivityIntentData
  • SetComponentSpeedupRateByMessageSkip

Rance X -> Evenicle 2

Signature Changes

  • Save
    • Now takes a boolean "compress" argument
  • AddPartsConstructionProcess

The following functions use the new ref type (called "wrap" currently in alice-tools) but are otherwise identical:

  • GetActivityParts
  • LoadBackScene
  • LoadParts
  • Load
  • ReleaseActivity
  • SaveActivityEXText
  • SaveBackScene
  • SaveParts
  • Debug_GetSpriteRect
  • GetButtonFontProperty
  • GetCGDetectionSurfaceArea
  • GetCheckBoxFontProperty
  • GetComboBoxFontProperty
  • GetComboBoxListBoxFontProperty
  • GetComponentAbsolutePos
  • GetComponentAbsoluteSquarePos
  • GetConstructionSurfaceArea
  • GetFlatSurfaceArea
  • GetFormGroupViewSnap
  • GetHGaugeSurfaceArea
  • GetKeyWaitCGName
  • GetListBoxFontProperty
  • GetLoopCGSurfaceArea
  • GetMessageWindowTextArea
  • GetMessageWindowTextFont
  • GetMessageWindowTextSpace
  • GetMultiTextBoxFontProperty
  • GetNumeralCGNumberWidthList
  • GetNumeralFont
  • GetNumeralSurfaceArea
  • GetPartsCGSurfaceArea
  • GetPartsConstructionProcess
  • GetPartsTextFontProperty
  • GetPartsTextSurfaceArea
  • GetRectangleDetectionPoint
  • GetRectangleDetectionSurfaceArea
  • GetSpinBoxFontProperty
  • GetTextBoxFontProperty
  • GetVGaugeSurfaceArea
  • Parts_GetPartsSize
  • Parts_GetPartsUpperLeftPos
  • Parts_GetRubyFont
  • RemoveController

New Functions

  • IsComponentSubColorMode
  • IsEnableInput
  • GetMessageUniqueID
  • SeekMessage
  • SetComponentSubColorMode
  • SetEnableInput
  • SetEventID

Removed Functions

  • GetMessageVariableCount
  • SetDelegateIndex

Evenicle 2 -> Haha Ranman

Signature Changes

None.

New Functions

  • GetHSliderBarScrollRate
  • GetVSliderBarScrollRate
  • GetHSliderBarScrollPos
  • GetHSliderBarTotalSize
  • GetHSliderBarViewSize
  • GetHSliderTotalSizeLinkNumber
  • GetHSliderViewSizeLinkNumber
  • GetMessageWindowRubyCharSpace
  • GetMessageWindowRubyLineSpace
  • GetMultiTextBoxMode
  • GetVSliderBarScrollPos
  • GetVSliderBarTotalSize
  • GetVSliderBarViewSize
  • GetVSliderTotalSizeLinkNumber
  • GetVSliderViewSizeLinkNumber
  • GetHSliderBarCGName
  • GetHSliderBarFlatName
  • GetHSliderBarOverrideBarCGName
  • GetHSliderBarOverrideBarFlatName
  • GetHSliderBarOverrideBGCGName
  • GetHSliderBarOverrideBGFlatName
  • GetVSliderBarCGName
  • GetVSliderBarFlatName
  • GetVSliderBarOverrideBarCGName
  • GetVSliderBarOverrideBarFlatName
  • GetVSliderBarOverrideBGCGName
  • GetVSliderBarOverrideBGFlatName
  • GetMessageWindowRubyFont
  • SetHSliderBarCGName
  • SetHSliderBarFlatName
  • SetHSliderBarOverrideBarCGName
  • SetHSliderBarOverrideBarFlatName
  • SetHSliderBarOverrideBGCGName
  • SetHSliderBarOverrideBGFlatName
  • SetHSliderBarScrollPos
  • SetHSliderBarScrollRate
  • SetHSliderBarSize
  • SetHSliderBarTotalSize
  • SetHSliderBarViewSize
  • SetHSliderTotalSizeLinkNumber
  • SetHSliderViewSizeLinkNumber
  • SetMessageWindowRubyCharSpace
  • SetMessageWindowRubyFont
  • SetMessageWindowRubyLineSpace
  • SetMultiTextBoxMode
  • SetVSliderBarCGName
  • SetVSliderBarFlatName
  • SetVSliderBarOverrideBarCGName
  • SetVSliderBarOverrideBarFlatName
  • SetVSliderBarOverrideBGCGName
  • SetVSliderBarOverrideBGFlatName
  • SetVSliderBarScrollPos
  • SetVSliderBarScrollRate
  • SetVSliderBarSize
  • SetVSliderBarTotalSize
  • SetVSliderBarViewSize
  • SetVSliderTotalSizeLinkNumber
  • SetVSliderViewSizeLinkNumber

Removed Functions

None.

Dohna Dohna

TODO

HENTAI LABYRINTH

TODO

Healing Touch

TODO