{"id":15417325,"url":"https://github.com/walbourn/directxtk12modelviewer","last_synced_at":"2025-04-15T11:53:50.612Z","repository":{"id":11412222,"uuid":"69596109","full_name":"walbourn/directxtk12modelviewer","owner":"walbourn","description":"A SDKMESH/CMO model viewer using DirectX Tool Kit for DirectX 12","archived":false,"fork":false,"pushed_at":"2024-06-05T17:05:37.000Z","size":26367,"stargazers_count":22,"open_issues_count":3,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-28T19:45:10.269Z","etag":null,"topics":["directxtk"],"latest_commit_sha":null,"homepage":"https://github.com/Microsoft/DirectXTK12","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/walbourn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-29T18:30:01.000Z","updated_at":"2025-03-13T18:58:50.000Z","dependencies_parsed_at":"2024-01-02T01:11:21.241Z","dependency_job_id":"bd4674fe-f283-4d32-8b8c-c6c2f05b89fb","html_url":"https://github.com/walbourn/directxtk12modelviewer","commit_stats":{"total_commits":157,"total_committers":5,"mean_commits":31.4,"dds":0.2738853503184714,"last_synced_commit":"c42df7c8ee6bb973e11ba745ef3e948c8a1c46a8"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walbourn%2Fdirectxtk12modelviewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walbourn%2Fdirectxtk12modelviewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walbourn%2Fdirectxtk12modelviewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walbourn%2Fdirectxtk12modelviewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/walbourn","download_url":"https://codeload.github.com/walbourn/directxtk12modelviewer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067759,"owners_count":21207395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["directxtk"],"created_at":"2024-10-01T17:15:17.613Z","updated_at":"2025-04-15T11:53:50.592Z","avatar_url":"https://github.com/walbourn.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"![DirectX Logo](https://raw.githubusercontent.com/wiki/Microsoft/DirectXTK12/X_jpg.jpg)\n\n# Model Viewer for DirectX Tool Kit for DirectX 12\n\nCopyright (c) Microsoft Corporation.\n\n**June 5, 2024**\n\nThe DirectX Tool Kit Model Viewer is an interactive test application for validating ``.SDKMESH``, ``.VBO``, and ``.CMO`` files rendered using the DirectX Tool Kit.\n\nThis code is designed to build with Visual Studio VS 2019 (16.11) or later.\n\n## Notices\n\nAll content and source code for this package are subject to the terms of the [MIT License](https://github.com/walbourn/directxtk12modelviewer/blob/main/LICENSE).\n\nFor the latest version of the Model Viewer for DirectX Tool Kit, bug reports and feature requests,\nplease visit the project site on [GitHub](http://aka.ms/directxtk12modelviewer).\n\n## Build Instructions\n\n### PC\n\nRun VS 2019\n\nOpen Project/Solution... ``DirectXTKModelViewer_Desktop_2019_Win10.sln``\n\nEnsure ``DirectXTKModelViewer_Desktop_2019_Win10`` is the \"StartUp Project\"\n\nBuild and Run (F5)\n\n### Xbox\n\nRun VS 2019\n\nOpen Project/Solution... ``DirectXTKModelViewer_GDK_2019.sln``\n\nEnsure ``DirectXTKModelViewer_*`` is the \"StartUp Project\"\n\nBuild and Run (F5) or use Deploy Solution\n\n\u003e For GDK, you can use the -render4K command-line option.\n\n## Usage\n### PC\n\nIf a Xbox 360 or Xbox One gamepad controller is plugged into the PC it can be used to control the viewer (see below for details). If you press the \"View\" button, an Open File Dialog is used to select the model (.SDKMESH or .VBO) to load.\n\nIf no controller is plugged in, you can use keyboard \u0026 mouse controls. If you press the \"O\" key, an Open File Dialog is used to select the model (.SDKMESH or .VBO) to load.\n\n#### Mouse\n\n* Press and hold LEFT mouse button to rotate view (SHIFT+LEFT button rotates object instead)\n\n* Press and hold RIGHT mouse button to translate view in XY (SHIFT+RIGHT translates in Z)\n\n* Scroll wheel controls zoom (i.e. distance between camera and focus point)\n\n#### Keyboard\n\n    W/S and PageUp/PageDown translates in Z\n    A/D and Left/Right translates in X\n    Up/Down translates in Y\n    Q/E rotate left/right\n\n    B toggles culling mode\n    C cycles background color\n    G toggles the grid display\n    H toggles HUD display\n    J toggles the cross display\n    R toggles wireframe\n    L toggles lighting vs. unlit (BasicEffect only)\n    T cycles tone-mapping operator\n    N cycles bone rendering mode (World vs. Rigid/Skinnned)\n\n    [/] scales the FOV\n    +/- scales the grid size\n\n    O loads model\n\n    Enter/Backspace cycles Image-Based Lighting for PBR models\n\n    Home key resets camera to default position\n\n    End key resets model to default rotation\n\n### Xbox\n\nFor Xbox, only the gamepad controls are available. When you press the \"View\" button, the tool enumerates the .SDKMESH and .VBO files in the root of the D:\\ drive and allows you to select one of them to load.\n\n#### GamePad\n\n    A - Change modes Orbit vs. FPS\n    B - Toggles wireframe/culling/lighting mode\n    X - Cycles grid, viewpoint cross, and HUD display\n    Y - Cycle background color\n    Menu - Cycle tone-mapping operator\n\n    DPAD\n        U – Translate Up\n        D – Translate Down\n        R – Translate Right\n        L – Translate Left\n\n    Right Trigger - Increment FOV\n    Left Trigger – Decrement FOV\n\n    Right Bumper – Increment translate sensitivity\n    Left Bumper – Decrement translate sensitivity\n\n    Left Thumbstick button - Frame scene extents\n\n    Orbit\n        Right Thumbstick\n              R – Orbit Right\n              L – Orbit Left\n              U – Orbit Up\n              D – Orbit Down\n              Click – Reset View to Default\n\n        Left Thumbstick\n              R – Rotate (Roll) Right\n              L – Rotate (Roll) Left\n              U – Move towards view point\n              D – Move away from view point\n              Click - cycles bone rendering mode\n\n    FPS\n        Right Thumbstick\n              R – Rotate Right\n              L – Rotate Left\n              U – Rotate Up\n              D – Rotate Down\n\n        Left Thumbstick\n              R – Translate Right\n              L – Translate Left\n              U – Translate Forward\n              D – Translate Back\n              Click - cycles bone rendering mode\n\nFor Xbox, after you start up the viewer app, you can use the Xbox Developer Command Prompt to copy data files to the system:\n\n```\nxbcp /x/title \u003csource directory\u003e xd:\\\n```\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.\n\n## Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark \u0026 Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwalbourn%2Fdirectxtk12modelviewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwalbourn%2Fdirectxtk12modelviewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwalbourn%2Fdirectxtk12modelviewer/lists"}