forked from Helco/PLocalSim
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
113 lines (104 loc) · 5.08 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
[PebbleLocalSimulator]
Version: 0.2 BETA
[Overview]
This project is an extension to the PebbleSDK2.0 Beta2 which allows you to build and run your pebble
applications on your computer.
[Installation and Use]
For OS specific manuals see linux.txt/windows.txt/mac.txt
The simulator has several key commands you can use:
[Arrow up] Pebble button: Up
[Arrow down] Pebble button: Down
[Enter] Pebble button: Select
[Backspace] Pebble button: Back
[+] Add 10% charge to the battery
[-] Drain 10% charge from the battery
[x][y][z] Simulate an accelerometer tap on the X/Y/Z axis with +1 direction
[X][Y][Z] Simulate an accelerometer tap on the X/Y/Z axis with -1 direction
[F1] Changes the color of the drawn pebble
[F2] Toggles the lens effect
[F3] Switches between 24H and 12H mode
[F4] Toggles bluetooth on / off
[F5] Toggle charger plugged / not plugged
[F12] Saves a screenshot in <simulator>\simdata\screenshots\
[Non-implemented features]
There are some things that are not implemented yet:
Dictionary - Because this seems to be used only for mobile phone
communication
AppMessage - Because this is hard to implement into a simulator, I
AppSync would like to ask you, how this should be implemented
MenuLayer
SimpleMenuLayer
NumberWindow
Accelerosensor (accel_tap_* is supported)
JavaScript API
Except from these, all other features should be implemented
[Compatibility]
The most important feature for this simulator is compability. You should be able to leave your
source code like it is for your watch, but there are a few problems:
- Non-implemented features. Very simple. I try to implement all features left as soon
as possible. At the moment this simulator is my only possibility to actual code for
pebble, so it is in my own interest to work as quick and as best as I can.
- Bugs. This simulator has lots of code, lots of unverified or not enough verified code
and there are probably lots of little bugs crawling inside of it. This is an
important reason why I release it now. I can not find all bugs but with your help
the search will be much easier.
- Documentation. Even though there is much more than I expected, I can not make sure that
all functions behave like their original ones. If you find any differences, please tell
then to me.
- Fonts. The fonts that are most common on the pebble are Bitham (renamed from Gotham) and
Gothic. I presume that they are commercial fonts which could be extracted from the firm
ware, but I think this would be illegal. In the case that you have these fonts (as True
TypeFont) you can replace them, as I filled the missing fonts up with Droid Serif and
Roboto which have a free license (you can find the fonts and their license text in the
directory local/simdata/systemFonts).
The problem with these fonts are, that they are wider than the original ones, so some
applications have graphical bugs because of this.
In the most sample watches, where this was a problem, it could be solved with extending
the layer frame with and reducing the margin.
I tested the sample watches from the SDK to detect these problems:
big_time [No problems]
classio [Minor font problem]
classio-battery-connection [Minor font problem]
drop_zone [No problems]
fuzzy_time [No problems]
just_a_bit [No problems]
ninety_one_dub [Probably invalid? day_name_layer is being used without initialising]
onthebutton [Minor font and margin problems]
rumbletime [No problems]
segment_six [No problems]
simple_analog [No problems]
simplicity [No problems]
tic_tock_toe [No problems]
Pretty good result, isn't it :)
[Compatibility between different operating systems]
[I want YOU!]
... to find:
- bugs
- suggestions
- feedback
- questions
and tell them to me. I will try to answer them all
[License]
The fonts are copyright by Google Inc. under Apache License, Version 2.0
The pebble pictures are copyright by Chaotic
The used libraries (see [Credits]) are copyright by their copyright holder (not me)
The actual simulator and the custom resource compiler (C version) are licensed by Helco (me) under GNU GPL v3
The python based resource compiler was placed in the public domain by Shirk
additionalSource/strftime.c stands under Public Domain (is part of MinGW I suppose)
[Credits]
Many many thanks to:
https://github.com/robhh - for his AppTimer implementation
Otto Greenslade (Chaotic) - for his pebble pictures
https://github.com/abl - for his empebble (which was original the basecode of this simulator, now
nearly all code is rewritten)
https://github.com/AmandaCameron - for his metadata support implementation (in PebbleSDK 1.2)
https://github.com/epatel - for his mac support
https://github.com/Shirk - for creating the python based resCompiler for unix systems
The Pebble Team - for the amazing watch, the SDK and their long shipping procedure, which was the
motivation to build this
Libraries that I used:
SDL 1.2 (www.libsdl.org)
SDL_ttf (http://www.libsdl.org/projects/SDL_ttf/)
SDL_image (http://www.libsdl.org/projects/SDL_image/)
SDL_gfx (http://www.ferzkopp.net/joomla/content/view/19/14/)
JSMN (https://bitbucket.org/zserge/jsmn)