Kanzi 3.2 移行ガイド¶

Kanzi 3.2 マイグレーションガイドには、以前の Kanzi リリースから既存の Kanzi アプリケーションを移植するための情報と手順が含まれています。

Kanzi Studio の変更¶

デフォルトテクスチャ (Default Texture)¶

Kanzi Studio プロジェクトを Kanzi Studio 3.1.1 から Kanzi Studio 3.2 に移行する際、Kanzi Studio は Default Texture Single Texture と Default Texture が使用する DefaultBackgroundImage.png 画像を作成します。

Kanzi Engine の変更¶

OpenGL ラッパー関数 kzsGl*() は、現在インライン関数ではなく非インライン関数として実装されています。

Kanzi 3.2では、デフォルトのスワップ動作がコピーからスワップに変更されました。これにより、新しいフレームのレンダリングは、前のフレームでレンダリングされたものではなく、空の状態から始まります。KzsSurfaceProperties を参照してください。

コピーを使用したい場合は、Application クラスで次を使用します。

virtual void onConfigure(ApplicationProperties& configuration) KZ_OVERRIDE
{
    <base class>::onConfigure(configuration);
    configuration.defaultSurfaceProperties.swapBehaviorCopy = 1;
}

Kanzi 名前空間には、std 名前空間からの C++ 機能が含まれています。¶

Kanzi 名前空間には、shared_ptr、vector、string などの std 名前空間からの C++ 機能が含まれています。例えば、<vector> の代わりに <kanzi/platform/vector.hpp> を含めます。

Mesh の変更¶

プリミティブメッシュ (Box, Sphere, Plane) は、ターゲットハードウェアがサポートしている場合、ハーフフロート頂点データ型を使用します。

Kanzi 3.1.1	Kanzi 3.2
`PrimitiveType`	`GraphicsPrimitiveType`
`MeshVertexAttribute`	`VertexAttribute`
`MeshVertexAttributeDataType`	`GraphicsDataType`
`MeshVertexAttributeDataType::FLOAT32`	`GraphicsDataTypeSFLOAT32`
`MeshVertexAttributeSemantic::Value`	`VertexAttribute::Semantic`
`MeshVertexAttributeSemantic::POSITION`	`VertexAttribute::SemanticPosition`

レンダラーの変更¶

kzcRenderer は現在 kanzi::Renderer です。

ヘッダー core/renderer/kzc_renderer.h は kanzi/rendering/renderer.hpp に置き換えられました。
ヘッダー core/renderer/kzc_gpu_buffer_manager.h は kanzi/rendering/gpu_buffer_manager.hpp に置き換えられました。
ヘッダー core/util/image/kzc_etc.h は user/image/kzc_etc.h に置き換えられます。
構造体 kzcRenderer は Renderer に置き換えられます。

Kanzi 3.1.1 関数	Kanzi 3.2 関数
`kzcRendererGetGPUBufferManager()`	`Renderer::getGPUBufferManager()`
`kzcRendererGenerateBuffer()`	`Renderer::generateBuffer()`
`kzcRendererDeleteBuffer()`	`Renderer::deleteBuffer()`
`kzcRendererSetVertexBuffer()`	`Renderer::setVertexBuffer()`
`kzcRendererSetVertexBufferData()`	`Renderer::setVertexBufferData()`
`kzcRendererEnableVertexAttributeArray()`	`Renderer::enableVertexAttributeArray()` `Renderer::disableVertexAttributeArray()`
`kzcRendererSetVertexBufferPointer()`	`Renderer::setVertexBufferPointer()`
`kzcRendererSetIndexBuffer()`	`Renderer::setIndexBuffer()`
`kzcRendererSetIndexBufferData()`	`Renderer::setIndexBufferData()`
`kzcRendererSetIndexData()`	`Renderer::setIndexData()`
`kzcRendererSetIndexCount()`	`Renderer::setIndexCount()`
`kzcRendererSetPrimitiveType()`	`Renderer::setPrimitiveType()`
`kzcRendererGenerateFrameBuffer()`	`Renderer::generateFramebuffer()`
`kzcRendererBindFrameBuffer()`	`Renderer::bindFramebuffer()`
`kzcRendererIsFrameBufferComplete()`	`Renderer::isFramebufferComplete()`
`kzcRendererDeleteFrameBuffer()`	`Renderer::deleteFramebuffer()`
`kzcRendererSetActiveFrameBuffer()`	`Renderer::setActiveFramebuffer()`
`kzcRendererResetActiveFrameBuffer()`	`Renderer::resetActiveFramebuffer()`
`kzcRendererFrameBufferRenderBuffer()`	`Renderer::framebufferRenderbuffer()`
`kzcRendererFrameBufferTexture2D()`	`Renderer::framebufferTexture2D()`
`kzcRendererGenerateRenderBuffer()`	`Renderer::generateRenderbuffer()`
`kzcRendererBindRenderBuffer()`	`Renderer::bindRenderbuffer()`
`kzcRendererRenderBufferStorage()`	`Renderer::renderbufferStorage()`
`kzcRendererDeleteRenderBuffer()`	`Renderer::deleteRenderbuffer()`
`kzcRendererIsClearEnabled()`	`Renderer::isClearEnabled()`
`kzcRendererCreateShader()`	`Renderer::createShader()`
`kzcRendererCompileSourceShader()`	`Renderer::compileSourceShader()`
`kzcRendererDeployBinaryShader()`	`Renderer::deployBinaryShader()`
`kzcRendererCreateShaderProgram()`	`Renderer::createShaderProgram()`
`kzcRendererAttachShaderToProgram()`	`Renderer::attachShaderToProgram()`
`kzcRendererBindAttributeToLocation()`	`Renderer::bindAttributeToLocation()`
`kzcRendererLinkShader()`	`Renderer::linkShader()`
`kzcRendererProgramBinary()`	`Renderer::programBinary()`
`kzcRendererDeleteShader()`	`Renderer::deleteShader()`
`kzcRendererSetActiveVertexAttributeMap()`	`Renderer::setActiveShaderHandle()`
`kzcRendererSetVertexCount()`	`Renderer::setVertexCount()`
`kzcRendererEnableState()`	`Renderer::enableState()`
`kzcRendererDisableState()`	`Renderer::disableState()`
`kzcRendererGetState()`	`Renderer::getState()`
`kzcRendererSetClearColor()`	`Renderer::setClearColor()`
`kzcRendererSetClearDepthValue()`	`Renderer::setClearDepthValue()`
`kzcRendererSetClearStencil()`	`Renderer::setClearStencil()`
`kzcRendererSetColorWriteMode()`	`Renderer::setColorWriteMode()`
`kzcRendererSetViewport()`	`Renderer::setViewport()`
`kzcRendererSetScissorTest()`	`Renderer::setScissorTest()`
`kzcRendererSetDepthTest()`	`Renderer::setDepthTest()`
`kzcRendererSetMatrix()`	`Renderer::setMatrix()`
`kzuRendererApplyCameraMatrix()`	`Renderer::applyCameraMatrix()`
`kzuRendererApplyLight()`	`Renderer::applyLight()`
`kzcRendererResetClearTarget()`	`Renderer::resetClearTarget()`
`kzcRendererGetUniformLocation()`	`Renderer::getUniformArrayLength()`
`kzcRendererGetUniformTexture()`	`Renderer::getUniformTexture()`
`kzcRendererSetUniformVecArray()`	`Renderer::setUniformVecArray()`
`kzcRendererGenerateTexture()`	`Renderer::generateTexture()`
`kzcRendererBindTexture()`	`Renderer::bindTexture()`
`kzcRendererSetTextureFilter()`	`Renderer::setTextureFilter()`
`kzcRendererSetTextureAddressingMode()`	`Renderer::setTextureAddressingMode()`
`kzcRendererSetTextureImage2D()`	`Renderer::setTextureImage2D()`
`kzcRendererSetCompressedTextureImage2D()`	`Renderer::setCompressedTextureImage2D()`
`kzcRendererSetTextureSubImage2D()`	`Renderer::setTextureSubImage2D()`
`kzcRendererApplyTexture()`	`Renderer::applyTexture()`
`kzcRendererGenerateMipmap()`	`Renderer::generateMipmap()`
`kzcRendererDeleteTexture()`	`Renderer::deleteTexture()`
`kzcRendererGetMaximumTextureSize()`	`Renderer::getMaximumTextureSize()`
`kzcRendererGetMaximumRenderbufferSize()`	`Renderer::getMaximumRenderbufferSize()`
`kzcRendererGetMaximumViewportWidth()`	`Renderer::getMaximumViewportWidth()`
`kzcRendererGetMaximumViewportHeight()`	`Renderer::getMaximumViewportHeight()`
`kzuRendererResetPass()`	`Renderer3D::resetPass()`
`kzuRendererSetOverrideMaterial()`	`Renderer3D::setOverrideMaterial()`
`kzuRendererSetTransformedObjectList()`	`Renderer3D::setTransformedObjectList()`
`kzuRendererSetSortByShader()`	`Renderer3D::setSortByShader()`
`kzuRendererIsSortByShader()`	`Renderer3D::isSortByShader()`
`kzuRendererResolveBatchQueue()`	`Renderer3D::resolveBatchQueue()`
`kzuRendererGetClearColorBufferOverride()`	`Renderer3D::getClearColorBufferOverride()`
`kzuRendererGetClearColorOverride()`	`Renderer3D::getClearColorOverride()`
`kzuRendererGetCullFaceOverride()`	`Renderer3D::getCullFaceOverride()`
`kzuRendererApplyStencilSettings()`	`Renderer3D::applyStencilSettings()`
`kzuRendererDrawPrimitiveBufferTextured()`	`Renderer3D::drawPrimitiveBufferTextured()`
`kzuRendererGetPropertyQuery()`	`Renderer3D::getPropertyQuery()`

Kanzi 3.1.1 列挙型	Kanzi 3.2 列挙型
`KzcRendererClearTarget`	`GraphicsClearTarget`
`KzcRendererBlendMode`	`GraphicsBlendMode`
`KzcRendererDepthTest`	`GraphicsCompareFunction`
`KzcRendererState`	`Renderer::State`
`KzcRendererMatrix`	`Renderer::FixedMatrix`
`KzcRendererCullMode`	`GraphicsCullMode`
`KzcRendererStencilFunction`	`GraphicsCompareFunction`
`KzcRendererStencilOperation`	`GraphicsStencilOperation`

Renderer3Dの変更¶

kzuRenderer は現在 kanzi::Renderer3D です。

ヘッダー user/renderer/kzu_renderer.h と user/renderer/kzu_renderer_util.h は kanzi/graphics_3d/renderer3d.hpp に置き換えられました。
構造体 kzuRenderer は Renderer3D に置き換えられます。

KzuTransformedScene は TransformedScene3D に置き換えられます。

Kanzi 3.1.1 関数	Kanzi 3.2 関数
`kzuRendererResetPass()`	`Renderer3D::resetPass()`
`kzuRendererSetOverrideMaterial()`	`Renderer3D::setOverrideMaterial()`
`kzuRendererSetTransformedObjectList()`	`Renderer3D::setTransformedObjectList()`
`kzuRendererSetSortByShader()`	`Renderer3D::setSortByShader()`
`kzuRendererIsSortByShader()`	`Renderer3D::isSortByShader()`
`kzuRendererResolveBatchQueue()`	`Renderer3D::resolveBatchQueue()`
`kzuRendererGetClearColorBufferOverride()`	`Renderer3D::getClearColorBufferOverride()`
`kzuRendererGetClearColorOverride()`	`Renderer3D::getClearColorOverride()`
`kzuRendererGetCullFaceOverride()`	`Renderer3D::getCullFaceOverride()`
`kzuRendererApplyStencilSettings()`	`Renderer3D::applyStencilSettings()`
`kzuRendererDrawPrimitiveBufferTextured()`	`Renderer3D::drawPrimitiveBufferTextured()`
`kzuRendererGetPropertyQuery()`	`Renderer3D::getPropertyQuery()`

Kanzi 3.1.1 列挙型	Kanzi 3.2 列挙型
`KzuCullMode`	`GraphicsCullMode`
`KzuColorWriteMode`	`GraphicsColorWriteMode`
`KzuStencilOperation`	`GraphicsStencilOperation`
`KzuStencilFunction`	`GraphicsCompareFunction`

リソース (Resources)¶

Kanzi 3.1.1 関数	Kanzi 3.2 関数
`kzuResourceLoad()`	`Resource::load()`
`kzuResourceIsLoaded()`	`Resource::isLoaded()`

GPU リソース (GPU resources)¶

Kanzi 3.1.1 関数	Kanzi 3.2 関数
`GPUResource::getDeploymentStrategy()`	`GPUResource::getDeployOnLoad()`
`GPUResource::setDeploymentStrategy()`	`GPUResource::setDeployOnLoad()`

フレームバッファ¶

要求された形式がサポートされていない場合、これらの関数はフォールバックテクスチャ形式を使用しようとします。

Framebuffer::addTexture()
Framebuffer::addRenderbuffer()

Kanzi 3.1.1 列挙型	Kanzi 3.2 列挙型
`FramebufferAttachment`	`Framebuffer::Attachment`
`APIFramebufferAttachment`	`Surface::APIAttachment`

テクスチャ (Texture)¶

Kanzi 3.1.1 列挙型	Kanzi 3.2 列挙型
`TextureTarget::Value`	`Texture::Target`
`TextureFlag::Value`	`Texture::CreateFlags`
`TextureFilter`	`Sampler::Filter`
`TextureMipmapMode`	`Sampler::MipmapMode`
`TextureAddressingMode`	`Sampler::AddressingMode`

シェーダー (Shader)¶

Kanzi 3.1.1 列挙型	Kanzi 3.2 列挙型
`ShaderType::Value`	`Shader::ProgramType`