{"id":51985793,"url":"https://github.com/node-3d/plugin-qml","last_synced_at":"2026-07-30T19:01:32.799Z","repository":{"id":16615602,"uuid":"80341367","full_name":"node-3d/plugin-qml","owner":"node-3d","description":"QML 2D graphics plugin for Node.js 3D Core","archived":false,"fork":false,"pushed_at":"2026-07-15T19:21:16.000Z","size":2311,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-07-15T21:19:15.774Z","etag":null,"topics":["2d","graphics","gui","javascript","js","node-3d","plugin","qml"],"latest_commit_sha":null,"homepage":"https://github.com/node-3d/node-3d","language":"TypeScript","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/node-3d.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-01-29T11:02:44.000Z","updated_at":"2026-07-15T19:21:20.000Z","dependencies_parsed_at":"2025-01-14T14:40:26.467Z","dependency_job_id":"96c6465a-91b8-4b28-b21c-89fd22e7d5cb","html_url":"https://github.com/node-3d/plugin-qml","commit_stats":{"total_commits":96,"total_committers":2,"mean_commits":48.0,"dds":"0.38541666666666663","last_synced_commit":"970f3f6fac09d7e0d3143e9a1dc96651220dc6fd"},"previous_names":["raub/node-3d-qml"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/node-3d/plugin-qml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/node-3d%2Fplugin-qml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/node-3d%2Fplugin-qml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/node-3d%2Fplugin-qml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/node-3d%2Fplugin-qml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/node-3d","download_url":"https://codeload.github.com/node-3d/plugin-qml/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/node-3d%2Fplugin-qml/sbom","scorecard":{"id":691768,"data":{"date":"2025-08-11","repo":{"name":"github.com/node-3d/3d-qml-raub","commit":"abbd6594766a9f73d9f6a60928fc53d376bcf168"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/eslint.yml:1","Warn: no topLevel permission defined: .github/workflows/publish.yml:1","Warn: no topLevel permission defined: .github/workflows/test.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":4,"reason":"dependency not pinned by hash detected -- score normalized to 4","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/eslint.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/eslint.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/eslint.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/eslint.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/publish.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/node-3d/3d-qml-raub/test.yml/master?enable=pin","Info:   0 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   2 out of   2 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":7,"reason":"3 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99","Warn: Project is vulnerable to: GHSA-xffm-g5w8-qvg7","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T02:28:21.923Z","repository_id":16615602,"created_at":"2025-08-22T02:28:21.924Z","updated_at":"2025-08-22T02:28:21.924Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36088336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-30T02:00:05.956Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["2d","graphics","gui","javascript","js","node-3d","plugin","qml"],"created_at":"2026-07-30T19:01:30.394Z","updated_at":"2026-07-30T19:01:32.733Z","avatar_url":"https://github.com/node-3d.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node.js 3D QML Helpers\n\nThis is a part of [Node3D](https://github.com/node-3d) project.\n\n[![NPM](https://badge.fury.io/js/@node-3d%2Fplugin-qml.svg)](https://badge.fury.io/js/@node-3d%2Fplugin-qml)\n[![Lint](https://github.com/node-3d/plugin-qml/actions/workflows/lint.yml/badge.svg)](https://github.com/node-3d/plugin-qml/actions/workflows/lint.yml)\n[![Test](https://github.com/node-3d/plugin-qml/actions/workflows/test.yml/badge.svg)](https://github.com/node-3d/plugin-qml/actions/workflows/test.yml)\n\n```bash\nnpm install @node-3d/plugin-qml\n```\n\n[QML](https://doc.qt.io/qt-6/qmlapplications.html)-rendering helpers for Node.js 3D Core.\nThe QML backend is **Qt 6.8.0**.\n\n![Example](examples/screenshot.png)\n\n\u003e Note: **IMPORTANT**, QML has its own OpenGL context. Make sure to switch back.\nUse `document.makeCurrent()` or `release()` (see exported below).\n\n```typescript\nimport * as three from 'three';\nimport { init, addThreeHelpers } from '@node-3d/core';\nimport { init as initQml } from '@node-3d/plugin-qml';\n\n// Standard Node3D init\nconst {\n\tdoc, Image: Img, gl,\n} = init({\n\tisGles3: true, isWebGL2: true, autoEsc: true,\n});\naddThreeHelpers(three);\n\n// Initialize QML and fetch the helpers\nconst {\n\tQmlOverlay, Property, Method, View, loop, release, textureFromId,\n} = initQml({\n\tdoc, gl, cwd: import.meta.dirname, three,\n});\n```\n\n* See [example](examples/fps/main.ts) for a complete setup.\n\n## API\n\n### `init(opts): TQml3D`\n\nInitializes QML rendering for a Node3D document and returns a cached object.\nRequired options:\n\n* `doc` - the `@node-3d/core` document.\n* `gl` - the WebGL/OpenGL API from `@node-3d/core`.\n* `three` - the Three.js module instance.\n* `cwd` - base directory for QML files. Defaults to `process.cwd()`.\n\nReturned helpers:\n\n* `View`, `Property`, `Method` - re-exported from `@node-3d/qml`.\n* `release()` - switches the active OpenGL context back to the Node3D document.\n* `loop(cb)` - updates QML, restores the document context, then runs `cb` every frame.\n* `textureFromId(id, renderer)` - wraps a QML texture ID as a Three.js `Texture`.\n* `QmlMaterial`, `QmlOverlayMaterial`, `QmlOverlay` - Three.js integration classes.\n\n### `QmlOverlay`\n\nLoads a QML view and exposes a Three.js mesh intended for full-screen overlays.\nAdd `overlay.mesh` to your scene, then listen to events emitted from QML via `eventEmit`.\n\n### `QmlMaterial` and `QmlOverlayMaterial`\n\nMaterials that use a QML `View` as their texture source. Use them when QML should appear\non arbitrary meshes or overlay planes.\n\nIt is also possible to run [QtQuick examples](https://doc.qt.io/qt-6/qtquick-codesamples.html)\non Node.js with this renderer. But it will only work with `QtQuick` components, i.e.\nnot `QtMultimedia`, `QtNetwork`, etc. - because those libs are not included.\nSee [Qt Quick Calqlatr](https://doc.qt.io/qt-6/qtquick-demos-calqlatr-example.html)\nexample being [copied](examples/qt-calqlatr) as a proof of concept.\n\n\n## QmlOverlay\n\nA common use-case is full-screen overlay UI:\n\n```typescript\n// Loads QML and creates all threejs-related resources, e.g. `overlay.mesh` is `THREE.Mesh`\nconst overlay = new QmlOverlay({ file: `${import.meta.dirname}/qml/Test.qml` });\nscene.add(overlay.mesh);\n\n// QML property access shortcut\nconst propTest = new Property\u003cstring\u003e({\n\tview: overlay, name: 'hud', key: 'testProp',\n});\n\n// A typed callable example\ntype TMethodTest = (arg0: number) =\u003e void;\nconst methodTest: TMethodTest = new Method({\n\tview: overlay, name: 'hud', key: 'testMethod',\n});\n\n// Listen to a user-defined event (could be any other name)\noverlay.on('custom-event', (event) =\u003e {\n\trelease();\n\tif (event.button === 'test') {\n\t\tconsole.log('test');\n\t}\n\tif (event.button === 'quit') {\n\t\tprocess.exit(0)\n\t}\n});\n\npropTest.value = 'test';\nmethodTest(123);\n```\n\nSee [examples](examples) for more details.\n\n\n## Any Material\n\nCreating a threejs `Texture` from QML `View` is also supported.\nSuch textures may be used in arbitrary threejs materials of your choice.\n\n```js\nconst testView = new View({ file: `${import.meta.dirname}/qml/Test.qml` });\nconst materialTest = new three.SpriteMaterial();\n\n// If the view already has some texture - use it\nmaterialTest.map = textureFromId(testView.textureId, renderer);\n\n// If the view creates a new texture - update the material\ntestView.on('reset', (textureId) =\u003e {\n\trelease();\n\tmaterialTest.map = textureFromId(textureId, renderer);\n});\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnode-3d%2Fplugin-qml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnode-3d%2Fplugin-qml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnode-3d%2Fplugin-qml/lists"}