Практическое руководство. Преобразование приложений Direct3D для настольных компьютеров

Обновлен: Ноябрь 2007

Возможно изменение существующего управляемого приложения Direct3D настольного компьютера для запуска на мобильном устройстве. Ниже перечислены изменения, которые необходимо внести в следующих областях:

• Ссылки на пространства имен и компоненты.

• Изменения конструктора Device и конструкторов других объектов.

• Удаление неподдерживаемых функциональных возможностей.

• Оптимизация ресурсов. Дополнительные сведения о разработке мобильных приложений Direct3D с оптимальным использованием ограниченных ресурсов см. в разделе Управление ресурсами устройства.

Примечание.
Управляемым мобильным приложениям Direct3D требуется программа Windows Mobile версии 5.0 для карманных ПК и смартфонов. Сведения о программе Windows Mobile и пакетах SDK см. в разделе Внешние ресурсы для платформы .NET Compact Framework.

Преобразование приложения Direct3D для настольных компьютеров

1. В среде Microsoft Visual Studio 2005 создайте приложение для интеллектуальных устройств с помощью шаблона для приложений под ОС Windows Mobile 5.0 для карманных ПК и смартфонов.

2. Добавьте в проект ссылку на компонент Microsoft.WindowsMobile.DirectX.

3. В соответствии с языком программирования добавьте оператор Imports или Using для следующих пространств имен:

   • Microsoft.WindowsMobile.DirectX

   • Microsoft.WindowsMobile.DirectX.Direct3D

4. Скопируйте код из приложения для настольных компьютеров и внесите необходимые изменения.

Чтобы изменить конструкторы, выполните следующие действия.

1. Для создания объекта Device для мобильных приложений требуются другие параметры, поэтому необходимы следующие изменения:

   • Значение Hardware не является поддерживаемым значением DeviceType. Замените его на значение Default.

   • Значение SoftwareVertexProcessing не является поддерживаемым значением CreateFlags. Замените его на значение None.

2. Используйте пул памяти, поддерживаемый мобильным устройством. Конструкторы TextureLoader и Mesh проверяют биты совместимости, чтобы обеспечить создание объектов в существующих пулах памяти, но другие конструкторы подобных проверок не делают. Дополнительные сведения о соответствующих битах совместимости, указывающих на то, что пул памяти используется на конкретном устройстве, см. в разделе Управление ресурсами устройства.

Удаление неподдерживаемых функциональных возможностей

1. Удалите члены, не существующие в платформе .NET Compact Framework, такие как члены перечисления VertexFormats версии только для настольных компьютеров.

2. Удалите вызовы метода Mesh.Load. В управляемый Direct3D для мобильных устройств не включен загрузчик файлов с расширением X. В документе Direct3D Mobile Meshes Sample показано, как загружать сетки с использованием пользовательского формата файлов с расширением md3dm. В нем представлен код, который преобразует файлы с расширением X в файлы с расширением md3dm и затем загружает их. Необходимо учитывать, что формат файлов md3dm не является компонентом платформы .NET Compact Framework, но приведен пример загрузки сетки с учетом того, что загрузка файлов с расширением X не поддерживается.

3. Удалите построители текстуры и вершинные построители текстуры

4. Убедитесь, что поддерживается требуемая цветовая палитра. Драйверы некоторых мобильных устройств не обеспечивают широкую палитру цветов для определенных разрешений экрана или текстур из-за жестких ограничений памяти. Убедитесь, что драйверы поддерживают требования цветовой палитры и внесите изменения при необходимости.

5. Удалите код, ссылающийся на следующие неподдерживаемые типы Direct3D:

   AllocateHierarchy AnimationOutput AnimationOutputFlags AnimationRootFrame AnimationSet AttributeWeights BandwidthTimings BasisType BoneCombination BoneInfluences Box CacheUtilization CallbackData CallbackSearchFlags CannotAttributeSortException CannotModifyIndexBufferException Channel CleanType ClipPlane ClipPlanes ColorOperator CompressedAnimationSet CompressionFlags CompressionQuality ConflictingRenderStateException ConflictingTextureFilterException ConflictingTexturePaletteException ConstantDescription ConstantTable ConstantTableDescription CubeMapFace CubeTexture CubeTextureRequirements CubeMapFace CubeTexture CubeTextureRequirements DeclarationMethod DeclarationType DeclarationTypeCaps DeclarationUsage DegenerateItems DegreeType DeviceInformation Direct3DXException DisplacementMap DisplacementParameter DriverCaps DuplicateNamedFragmentException Effect EffectCompiler EffectDefault EffectDefaultType EffectDescription EffectHandle EffectInstance EffectPool EffectStateManager EventDescription EventType ExtendedMaterial Fill2DTextureCallback Fill3DTextureCallback FormatList FragmentDescription FragmentLinker Frame FunctionDescription FX GammaRamp GlyphMetricsFloat GpuSimulatorOption HandleAnimationCallback ImageFileFormat ImageInformation Include IncludeType InterfaceGuid InterfaceTimings IntersectInformation InvalidDataException InvalidMeshException IssueFlags KeyCallback KeyFramedAnimationSet KeyQuaternion KeyVector3 Line LinePattern LoadedMeshHasNoDataException LoadUserData LockedBox Macro MeshContainer MeshData MyD3DXAllocateHierarchy MyD3DXAnimationCallback MyD3DXFrame MyD3DXIncludeClass MyD3DXLoadUserData MyD3DXMeshContainer MyD3DXSaveUserData

   NormalMap OutOfVideoMemoryException ParameterClass ParameterDescription ParameterFlags ParameterType PassDescription PatchEdge PatchInformation PatchMesh PatchType PipelineTimings PixelShader PixelShaderCaps PlaybackType Present PropertyDescription PrtBuffer PrtCompressedBuffer PrtEngine PrtEngineCallback PrtSplitMeshClusterData PrtSplitMeshVertexData Query QueryType RasterStatus RectanglePatchInformation RegisterSet RenderStates RenderTargetsMax RenderToEnvironmentDescription RenderToEnvironmentMap RenderToSurface RenderToSurfaceDescription ResourceManager ResourceStats SamplerStageStates SamplerStateManager SamplerStateManagerCollection SaveUserData ScaleRotateTranslate Semantic ShaderConstantInformation ShaderConstantTable ShaderDebugInformation ShaderFileInformation ShaderFlags ShaderInstructionInformation ShaderLoader ShaderStructMemberInformation ShaderTypeInformation ShaderVariableInformation ShaderWriteInformation SimplificationMesh SkinInformation SkinMesh SkinningNotSupportedException SphericalHarmonicMaterial SphericalHarmonics StageTimings StateBlock StateBlockType SurfaceLoader TextureGutterHelper TextureShader TextureStageStates TooManyInfluencesException TooManyOperationsException TrackDescription TransitionType TrianglePatchInformation UnsupportedAlphaArgumentException UnsupportedAlphaOperationException UnsupportedColorArgumentException UnsupportedColorOperationException UnsupportedFactorValueException UnsupportedTextureFilterException VertexCache VertexDeclaration VertexElement VertexFormatCaps VertexShader VertexShaderCaps VertexStats Volume VolumeDescription VolumeLoader VolumeTexture VolumeTextureRequirements WasStillDrawingException WeldEpsilons WeldEpsilonsFlags Wrap WrongTextureFormatException XFile XFileData XFileErrorCodes XFileFormat XFileGuid XFileManager XFileSaveData

См. также

Другие ресурсы

Мобильное программирование Direct3D в .NET Compact Framework