kivy/kivy3

3D graphics framework for Kivy.

Kivy3 - 3D graphics framework for Kivy

Kivy3 is the framework which helps people work with 3D elements and rendering within Kivy application. Basically with Kivy and Kivy3 you may create a 3D application for any platform Kivy supports, such as: iOS, Android, Windows, OSX, Linux (including Raspberry Pi).

Kivy3 provides a toolset and abstraction levels to work with 3D objects like Camera, Scene, Renderers, loaders you may use to load 3D objects.

Installation

First make sure that you have kivy installed on your machine. Mostly a simple:

$ pip install kivy

should be sufficient, but stable version will not include the latest features. For further info visit Kivy documentation. After successful Kivy installation install Kivy3 with this:

$ pip install https://github.com/kivy/kivy3/archive/master.zip

Packaging kivy3

Kivy3 is a pure python package, currently available only at GitHub, which means that for packaging it e.g. for Android you need to clone the folder to your application folder (the one with main.py). If you can run the app on a desktop machine, it should work even on other platforms.

Don't forget to add an include exception for additional files, such as shader (*.glsl) and other files you may find in the kivy3 folder.

kivy3's Issues

request_keyboard requires a widget not an app.

The camera example has the strange error:

   File "/home/owner/venv/kivy/lib/python3.9/site-packages/kivy/core/window/__init__.py", line 1728, in update_viewport
     targettop = max(0, target.to_window(0, target.y)[1]) if target else 0
 AttributeError: 'MainApp' object has no attribute 'to_window'

which can be solved by passing a widget not an app to request_keyboard.

Access to kivy3 on pypi

@KeyWeeUsr can you give me and @tshirtman maintainer access to https://pypi.org/project/kivy3/ please?

Thanks in advance!

Cleanup branches

Branches need a cleanup

• Remove all outdated feature branches
• Create release from current master (including shader file)
• Merge development to master

'NoneType' has no attribute 'tell'

I added some debugging code on my end (See the related kivy issue linked below for that code) and this seems to be due to the fact that empty.png is not getting added to the site-packages/kivy3/loaders directory (filename becomes None due to resource_find, but the code after resource_find doesn't check for None).

empty.png is missing, but it is not the only file missing.

Adding non-py files to setup.py explicitly seems necessary, since the following files don't get installed via pip install https://github.com/kivy/kivy3/archive/refs/heads/master.zip:

• kivy_env/lib/python3.9/site-packages/kivy3/loaders/empty.png
• kivy_env/lib/python3.9/site-packages/kivy3/default.glsl
• others?

The error was difficult to diagnose due to this kivy issue.

rotate_cam example

@JohnSumskas hi, what is the https://github.com/kivy/kivy3/blob/development/examples/rotate_cam.py example supposed to demonstrate?