123

.gitattributes

@@ -17,6 +17,7 @@
 *.pyd   binary
 *.pyo   binary
 *.obj   binary
+*.mtl   binary
 
 # Note: .db, .p, and .pkl files are associated
 # with the python modules ``pickle``, ``dbm.*``,

README.md

@@ -1,17 +1,33 @@
-# Kivy3 - 3d stuff framework for Kivy
+# Kivy3 - 3D graphics framework for Kivy
 
-Kivy3 is the framework which helps you to do some 3D elements and rendering within Kivy application. Basically with Kivy and Kivy3 you may create 3D application for any platform supported by Kivy like iOS, Android, Windows, OSX, Linux.
+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 you a toolset and abstraction levels to work with 3D objects like Camera, Scene, Renderers, loaders you may use to load 3D object etc.
+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. You may find instructions for installing Kivy framework [here](https://kivy.org/docs/installation/installation.html). When Kivy is installed, just follow next instruction:
+First make sure that you have `kivy` installed on your machine. Mostly
+a simple:
 
-```
-$ pip install https://github.com/nskrypnik/kivy3/zipball/master
-```
+    $ pip install kivy
+
+should be sufficient, but stable version will not include the latest features.
+For further info visit
+[Kivy documentation](https://kivy.org/docs/installation/installation.html).
+After successful Kivy installation install Kivy3 with this:
+
+    $ pip install https://github.com/KeyWeeUsr/kivy3/zipball/master
 
 # Packaging kivy3
 
-Comming soon...
+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.

examples/camera/main.py

@@ -14,6 +14,7 @@
 obj_file = os.path.join(_this_path, "../textures/orion.obj")
 mtl_file = os.path.join(_this_path, "../textures/orion.mtl")
 
+
 class MainApp(App):
 
     def build(self):
@@ -47,8 +48,8 @@ def _keyboard_closed(self):
         self._keyboard.unbind(on_key_down=self._on_keyboard_down)
         self._keyboard = None
 
-    def _on_keyboard_down(self,  keyboard, keycode, text, modifiers):
-        if  keycode[1] == 'w':
+    def _on_keyboard_down(self, keyboard, keycode, text, modifiers):
+        if keycode[1] == 'w':
             self.camera.pos.z -= 0.2
         elif keycode[1] == 's':
             self.camera.pos.z += 0.2

examples/example2.py

@@ -44,7 +44,7 @@ def build(self):
         camera = PerspectiveCamera(15, 1, 1, 1000)
         # load obj file
         loader = OBJLoader()
-        obj_path = os.path.join(os.path.dirname(__file__), "./testnurbs.obj")
+        obj_path = os.path.join(os.path.dirname(__file__), "./testnurbs-2.obj")
         obj = loader.load(obj_path)
 
         scene.add(*obj.children)

examples/testnurbs-2.mtl

@@ -0,0 +1,38 @@
+# Blender MTL File: 'None'
+# Material Count: 4
+
+newmtl wire_087224143
+Ns 29.411765
+Ka 0.000000 0.000000 0.000000
+Kd 0.272960 0.702720 0.448640
+Ks 0.350000 0.350000 0.350000
+Ni 1.000000
+d 1.000000
+illum 2
+
+newmtl wire_108008136
+Ns 29.411765
+Ka 0.000000 0.000000 0.000000
+Kd 0.338800 0.025120 0.426640
+Ks 0.350000 0.350000 0.350000
+Ni 1.000000
+d 1.000000
+illum 2
+
+newmtl wire_148177026
+Ns 29.411765
+Ka 0.000000 0.000000 0.000000
+Kd 0.464320 0.555280 0.081600
+Ks 0.350000 0.350000 0.350000
+Ni 1.000000
+d 1.000000
+illum 2
+
+newmtl wire_154154229
+Ns 29.411765
+Ka 0.000000 0.000000 0.000000
+Kd 0.483120 0.483120 0.718400
+Ks 0.350000 0.350000 0.350000
+Ni 1.000000
+d 1.000000
+illum 2