【Java】곱하기 색·스크린색

업데이트： 2022/12/08

모델에 곱하기 색·스크린색을 적용함으로써 색조를 실시간으로 변화시킬 수 있습니다.
Cubism Editor상에서 설정한 곱하기 색·스크린색은 Cubism4.2 이후의 Cubism Java Framework를 이용하는 것으로, 특별히 추가의 코딩을 하지 않고 적용됩니다.
Cubism Editor상에서의 곱하기 색·스크린색의 설정은 Editor 매뉴얼의 「곱하기 색・스크린색」을 참조해 주십시오.
또한 필요에 따라 코딩을 함으로써 SDK에서 곱하기 색·스크린색을 조작하여 다음과 같은 동작도 가능합니다.

• 인터랙티브에 곱하기 색·스크린색을 적용한다
• Cubism Editor에서 설정하지 않은 곱하기 색·스크린색 적용
• Cubism Editor에서 설정한 곱하기 색·스크린색을 비활성화

이후는 그 순서의 설명입니다.

처리 절차

이하의 흐름으로 처리를 실시합니다.

• 곱하기 색·스크린색의 덮어쓰기 플래그 설정
• 곱하기 색·스크린색의 설정
• 모델 그리기

곱하기 색·스크린색의 덮어쓰기 플래그 설정

우선은 곱하기 색·스크린색의 덮어쓰기 플래그를 true로 설정합니다. 디폴트는 false입니다.

model.getModel().setOverrideFlagForModelMultiplyColors(true); // 곱하기 색의 덮어쓰기 플래그
model.getModel().setOverrideFlagForModelScreenColors(true); // 스크린색의 덮어쓰기 플래그

public void setOverwriteFlagForModelMultiplyColors(boolean value) 및 public voidsetOverwriteFlagForModelScreenColors(boolean value)는 Framework의 CubismModel 클래스에 정의되어 있습니다.
Cubism SDK for Java의 샘플 프로젝트에서는 모델을 조작하기 위해 CubismModel을 기본 클래스로 한 LAppModel 클래스를 정의하고 있으며, 위 코드의 model은 LAppModel 클래스의 인스턴스입니다. 
LAppModel 클래스로부터 CubismModel 클래스의 메소드를 호출하기 위해서 getModel()을 중개하고 있습니다.

곱하기 색·스크린색의 설정

곱하기 색과 스크린색을 정의하고 모델에 설정합니다.
아래의 코드에서는 모든 Drawable에 대해 곱하기 색에 빨간색, 스크린색에 녹색을 설정하는 경우의 설정값입니다.
설정 색상은 RGBA를 사용할 수 있습니다.

for (int i = 0; i < model.getModel().getDrawableCount(); i++) {
    CubismRenderer.CubismTextureColor multiplyColor = new CubismRenderer.CubismTextureColor(); // 곱하기 색
    multiplyColor.r = 1.0f;
    multiplyColor.g = 0.5f;
    multiplyColor.b = 0.5f;
    multiplyColor.a = 1.0f;

    CubismRenderer.CubismTextureColor screenColor = new CubismRenderer.CubismTextureColor(); // 스크린색
    screenColor.r = 0.0f;
    screenColor.g = 0.5f;
    screenColor.b = 0.0f;
    screenColor.a = 1.0f;

    model.getModel().setMultiplyColor(i, multiplyColor);
    model.getModel().setScreenColor(i, screenColor);
}

곱하기 색·스크린색 적용 전

곱하기 색에 빨간색, 스크린색에 녹색을 적용한 후

모델의 DrawableCount로 루프 처리를 하면, 매 프레임에 모든 Drawable에 대해 곱하기 색·스크린색의 처리를 실시하는 형태가 됩니다.

CubismRenderer.CubismTextureColor multiplyColor = new CubismRenderer.CubismTextureColor(); // 곱하기 색
multiplyColor.r = 1.0f;
multiplyColor.g = 1.0f;
multiplyColor.b = 1.0f;
multiplyColor.a = 1.0f;

CubismRenderer.CubismTextureColor screenColor = new CubismRenderer.CubismTextureColor(); // 스크린색
screenColor.r = 0.0f;
screenColor.g = 0.0f;
screenColor.b = 0.0f;
screenColor.a = 1.0f;

모델 그리기

model.draw(projection);

Cubism SDK for Java의 샘플 프로젝트에서 원래 실시하고 있는 모델의 draw() 함수를 호출하는 것으로, Cubism JavaFramework 내부의 렌더링 처리에 의해 곱하기 색·스크린색을 포함한 모델이 렌더링 됩니다.

그 외 관련 함수

곱하기 색·스크린색의 덮어쓰기 플래그 취득

true로 설정하면 SDK에서 설정한 색 정보를 우선하고 false로 설정하면 모델의 색 정보를 우선합니다.

public boolean getOverwriteFlagForModelMultiplyColors(){...}   // 모델 전체의 곱하기 색 덮어쓰기 플래그 취득
public boolean getOverwriteFlagForScreenColors(){...}   // 모델 전체의 스크린색 덮어쓰기 플래그 취득

또한 각 Drawable에 대해 개별적인 덮어쓰기 플래그를 취득할 수도 있습니다.

public boolean getOverwriteFlagForDrawableMultiplyColors(int drawableIndex){...}   // 지정한 인덱스의 Drawable의 곱하기 색 덮어쓰기 플래그 취득
public boolean getOverwriteFlagForDrawableScreenColors(int drawableIndex){...}   // 지정한 인덱스의 Drawable의 스크린색 덮어쓰기 플래그 취득

곱하기 색·스크린색의 설정

위에서는 CubismRenderer.CubismTextureColor를 인수로 설정하는 방법을 설명했지만 RGBA를 직접 설정할 수 있는 메소드도 있습니다. (입력값 0.0~1.0)

public void setMultiplyColor(int drawableIndex, float r, float g, float b, float a){...}   // 곱하기 색 설정
public void setScreenColor(int drawableIndex, float r, float g, float b, float a){...}   // 스크린색 설정

곱하기 색·스크린색 취득

각 Drawable의 곱하기 색·스크린색을 CubismTextureColor형으로 취득합니다.

CubismRenderer.CubismTextureColor getMultiplyColor(int drawableIndex){...}
CubismRenderer.CubismTextureColor getScreenColor(int drawableIndex){...}

인수는 Drawable의 인덱스입니다.

Cubism Java Framework의 내부 처리

곱하기 색·스크린색을 표현하기 위한 Framework의 내부 처리입니다.
이하의 흐름으로 처리를 실시합니다.

1. Cubism Core Java로부터 모델의 곱하기 색·스크린색을 취득
2. 취득한 곱하기 색·스크린색을 덮어쓰기 플래그로 판별한다
3. 취득한 곱하기 색·스크린색을 셰이더 프로그램으로 설정한다
4. 프래그먼트 셰이더에 텍스처 컬러 계산 시 플래그·스크린색을 더한다

Cubism Core Java로부터 모델의 곱하기 색·스크린색을 취득

Cubism Core Java 내 CubismModel 클래스의 API를 이용해, 모델로부터 곱하기 색·스크린색의 모든 Drawable이 포함되는 배열을 취득합니다.
그 배열의 지정된 인덱스에 액세스해 그 값을 반환합니다.

public float[] getDrawableMultiplyColor(int drawableIndex) {
    return model.getDrawableViews()[drawableIndex].getMultiplyColors();
}

public float[] getDrawableScreenColor(int drawableIndex) {
    return model.getDrawableViews()[drawableIndex].getScreenColors();
}

Core Java에서는 moc3 파일을 로드했을 때에 모든 Drawable의 정보가 취득되어 멤버 배열에 보유됩니다.
SDK 측에서 곱하기 색·스크린색을 설정하는 경우는 setOverwriteFlagForModelMultiplyColors() 및 setOverwriteFlagForScreenColors()에 true를 설정한 다음, setMultiplyColor() 및 setScreenColor()로 멤버 배열을 덮어씁니다.
특정 Drawable에 대해서 곱하기 색·스크린색을 설정하는 경우는 setOverwriteFlagForDrawableMultiplyColors() 및 setOverwriteFlagForDrawableScreenColors()에 true를 설정해 같은 조작을 실시합니다.