52 |
89 |
101 |
105 |
106 |
--------------------------------------------------------------------------------
/templates/AndroidManifest.tmpl.xml:
--------------------------------------------------------------------------------
1 |
2 |
53 |
83 |
87 |
88 |
54 |
82 |
55 |
56 |
81 | Search
57 |
58 |
59 |
64 | 60 | Please activate JavaScript to enable the search 61 | functionality. 62 |
63 |65 | From here you can search these documents. Enter your search 66 | words into the box below and click "search". Note that the search 67 | function will automatically search for all of the words. Pages 68 | containing fewer words won't appear in the result list. 69 |
70 | 75 | 76 |
77 |
78 |
79 |
80 |
44 |
93 |
105 |
109 |
110 |
--------------------------------------------------------------------------------
/doc/py-modindex.html:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
45 |
74 |
91 |
92 |
46 |
73 |
47 |
48 |
72 |
49 |
69 |
70 |
71 | Supported Devices¶
50 |Generally, the Pygame Subset for Android supports smartphones and 51 | tablets supporting Android 2.0 or later. Games run far better if the 52 | device has hardware OpenGL support.
53 |We test new releases of the Pygame Subset for Android on the following 54 | devices:
55 |-
56 |
- Samsung Galaxy S Vibrant (SGH-T959) 57 |
- Motorola Xoom Wifi 58 |
We’ve had community reports that the Pygame Subset for Android works 60 | on:
61 |-
62 |
- Samsung Galaxy Tab (thanks Tony Santiago) 63 |
- Nexus S (thanks Ben Michie) 64 |
- Nexus One (thanks Valentine Blacker) 65 |
If you’d like to add a device to one of these lists, please email 67 | tom@rothamel.us.
68 |
47 |
103 |
115 |
119 |
120 |
--------------------------------------------------------------------------------
/src/org/xeustechnologies/jtar/TarOutputStream.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010 Xeus Technologies
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | *
16 | */
17 |
18 | package org.xeustechnologies.jtar;
19 |
20 | import java.io.FilterOutputStream;
21 | import java.io.IOException;
22 | import java.io.OutputStream;
23 |
24 | /**
25 | * @author Kamran Zafar
26 | *
27 | */
28 | public class TarOutputStream extends FilterOutputStream {
29 | private long bytesWritten;
30 | private long currentFileSize;
31 | private TarEntry currentEntry;
32 |
33 | public TarOutputStream(OutputStream out) {
34 | super( out );
35 | bytesWritten = 0;
36 | currentFileSize = 0;
37 | }
38 |
39 | /**
40 | * Appends the EOF record and closes the stream
41 | *
42 | * @see java.io.FilterOutputStream#close()
43 | */
44 | @Override
45 | public void close() throws IOException {
46 | closeCurrentEntry();
47 | write( new byte[TarConstants.EOF_BLOCK] );
48 | super.close();
49 | }
50 |
51 | /**
52 | * Writes a byte to the stream and updates byte counters
53 | *
54 | * @see java.io.FilterOutputStream#write(int)
55 | */
56 | @Override
57 | public void write(int b) throws IOException {
58 | super.write( b );
59 | bytesWritten += 1;
60 |
61 | if( currentEntry != null ) {
62 | currentFileSize += 1;
63 | }
64 | }
65 |
66 | /**
67 | * Checks if the bytes being written exceed the current entry size.
68 | *
69 | * @see java.io.FilterOutputStream#write(byte[], int, int)
70 | */
71 | @Override
72 | public void write(byte[] b, int off, int len) throws IOException {
73 | if( currentEntry != null && !currentEntry.isDirectory() ) {
74 | if( currentEntry.getSize() < currentFileSize + len ) {
75 | throw new IOException( "The current entry[" + currentEntry.getName() + "] size["
76 | + currentEntry.getSize() + "] is smaller than the bytes[" + ( currentFileSize + len )
77 | + "] being written." );
78 | }
79 | }
80 |
81 | super.write( b, off, len );
82 | }
83 |
84 | /**
85 | * Writes the next tar entry header on the stream
86 | *
87 | * @param entry
88 | * @throws IOException
89 | */
90 | public void putNextEntry(TarEntry entry) throws IOException {
91 | closeCurrentEntry();
92 |
93 | byte[] header = new byte[TarConstants.HEADER_BLOCK];
94 | entry.writeEntryHeader( header );
95 |
96 | write( header );
97 |
98 | currentEntry = entry;
99 | }
100 |
101 | /**
102 | * Closes the current tar entry
103 | *
104 | * @throws IOException
105 | */
106 | protected void closeCurrentEntry() throws IOException {
107 | if( currentEntry != null ) {
108 | if( currentEntry.getSize() > currentFileSize ) {
109 | throw new IOException( "The current entry[" + currentEntry.getName() + "] of size["
110 | + currentEntry.getSize() + "] has not been fully written." );
111 | }
112 |
113 | currentEntry = null;
114 | currentFileSize = 0;
115 |
116 | pad();
117 | }
118 | }
119 |
120 | /**
121 | * Pads the last content block
122 | *
123 | * @throws IOException
124 | */
125 | protected void pad() throws IOException {
126 | if( bytesWritten > 0 ) {
127 | int extra = (int) ( bytesWritten % TarConstants.DATA_BLOCK );
128 |
129 | if( extra > 0 ) {
130 | write( new byte[TarConstants.DATA_BLOCK - extra] );
131 | }
132 | }
133 | }
134 | }
135 |
--------------------------------------------------------------------------------
/src/org/renpy/android/Audio.java:
--------------------------------------------------------------------------------
1 | /*
2 | Simple DirectMedia Layer
3 | Java source code (C) 2009-2011 Sergii Pylypenko
4 |
5 | This software is provided 'as-is', without any express or implied
6 | warranty. In no event will the authors be held liable for any damages
7 | arising from the use of this software.
8 |
9 | Permission is granted to anyone to use this software for any purpose,
10 | including commercial applications, and to alter it and redistribute it
11 | freely, subject to the following restrictions:
12 |
13 | 1. The origin of this software must not be misrepresented; you must not
14 | claim that you wrote the original software. If you use this software
15 | in a product, an acknowledgment in the product documentation would be
16 | appreciated but is not required.
17 | 2. Altered source versions must be plainly marked as such, and must not be
18 | misrepresented as being the original software.
19 | 3. This notice may not be removed or altered from any source distribution.
20 | */
21 |
22 | package org.renpy.android;
23 |
24 |
25 | import android.app.Activity;
26 | import android.content.Context;
27 | import android.os.Bundle;
28 | import android.view.MotionEvent;
29 | import android.view.KeyEvent;
30 | import android.view.Window;
31 | import android.view.WindowManager;
32 | import android.media.AudioTrack;
33 | import android.media.AudioManager;
34 | import android.media.AudioFormat;
35 | import java.io.*;
36 | import java.nio.ByteBuffer;
37 | import android.util.Log;
38 | import java.lang.Thread;
39 |
40 |
41 | class AudioThread {
42 |
43 | private PythonActivity mParent;
44 | private AudioTrack mAudio;
45 | private byte[] mAudioBuffer;
46 | private int mVirtualBufSize;
47 |
48 | public AudioThread(PythonActivity parent)
49 | {
50 | mParent = parent;
51 | mAudio = null;
52 | mAudioBuffer = null;
53 | nativeAudioInitJavaCallbacks();
54 | }
55 |
56 | public int fillBuffer()
57 | {
58 | if( mParent.isPaused() )
59 | {
60 | try{
61 | Thread.sleep(200);
62 | } catch (InterruptedException e) {}
63 | }
64 | else
65 | {
66 | //if( Globals.AudioBufferConfig == 0 ) // Gives too much spam to logcat, makes things worse
67 | // mAudio.flush();
68 |
69 | mAudio.write( mAudioBuffer, 0, mVirtualBufSize );
70 | }
71 |
72 | return 1;
73 | }
74 |
75 | public int initAudio(int rate, int channels, int encoding, int bufSize)
76 | {
77 | if( mAudio == null )
78 | {
79 | channels = ( channels == 1 ) ? AudioFormat.CHANNEL_OUT_MONO :
80 | AudioFormat.CHANNEL_OUT_STEREO;
81 | encoding = ( encoding == 1 ) ? AudioFormat.ENCODING_PCM_16BIT :
82 | AudioFormat.ENCODING_PCM_8BIT;
83 |
84 | mVirtualBufSize = bufSize;
85 |
86 | if( AudioTrack.getMinBufferSize( rate, channels, encoding ) > bufSize )
87 | bufSize = AudioTrack.getMinBufferSize( rate, channels, encoding );
88 |
89 | /**
90 | if(Globals.AudioBufferConfig != 0) { // application's choice - use minimal buffer
91 | bufSize = (int)((float)bufSize * (((float)(Globals.AudioBufferConfig - 1) * 2.5f) + 1.0f));
92 | mVirtualBufSize = bufSize;
93 | }
94 | **/
95 | mAudioBuffer = new byte[bufSize];
96 |
97 | mAudio = new AudioTrack(AudioManager.STREAM_MUSIC,
98 | rate,
99 | channels,
100 | encoding,
101 | bufSize,
102 | AudioTrack.MODE_STREAM );
103 | mAudio.play();
104 | }
105 | return mVirtualBufSize;
106 | }
107 |
108 | public byte[] getBuffer()
109 | {
110 | return mAudioBuffer;
111 | }
112 |
113 | public int deinitAudio()
114 | {
115 | if( mAudio != null )
116 | {
117 | mAudio.stop();
118 | mAudio.release();
119 | mAudio = null;
120 | }
121 | mAudioBuffer = null;
122 | return 1;
123 | }
124 |
125 | public int initAudioThread()
126 | {
127 | // Make audio thread priority higher so audio thread won't get underrun
128 | Thread.currentThread().setPriority(Thread.MAX_PRIORITY);
129 | return 1;
130 | }
131 |
132 | public int pauseAudioPlayback()
133 | {
134 | if( mAudio != null )
135 | {
136 | mAudio.pause();
137 | return 1;
138 | }
139 | return 0;
140 | }
141 |
142 | public int resumeAudioPlayback()
143 | {
144 | if( mAudio != null )
145 | {
146 | mAudio.play();
147 | return 1;
148 | }
149 | return 0;
150 | }
151 |
152 | private native int nativeAudioInitJavaCallbacks();
153 | }
154 |
155 |
--------------------------------------------------------------------------------
/src/org/kamranzafar/jtar/Octal.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Kamran Zafar
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | *
16 | */
17 |
18 | package org.kamranzafar.jtar;
19 |
20 | /**
21 | * @author Kamran Zafar
22 | *
23 | */
24 | public class Octal {
25 |
26 | /**
27 | * Parse an octal string from a header buffer. This is used for the file
28 | * permission mode value.
29 | *
30 | * @param header
31 | * The header buffer from which to parse.
32 | * @param offset
33 | * The offset into the buffer from which to parse.
34 | * @param length
35 | * The number of header bytes to parse.
36 | *
37 | * @return The long value of the octal string.
38 | */
39 | public static long parseOctal(byte[] header, int offset, int length) {
40 | long result = 0;
41 | boolean stillPadding = true;
42 |
43 | int end = offset + length;
44 | for (int i = offset; i < end; ++i) {
45 | if (header[i] == 0)
46 | break;
47 |
48 | if (header[i] == (byte) ' ' || header[i] == '0') {
49 | if (stillPadding)
50 | continue;
51 |
52 | if (header[i] == (byte) ' ')
53 | break;
54 | }
55 |
56 | stillPadding = false;
57 |
58 | result = ( result << 3 ) + ( header[i] - '0' );
59 | }
60 |
61 | return result;
62 | }
63 |
64 | /**
65 | * Parse an octal integer from a header buffer.
66 | *
67 | * @param value
68 | * @param buf
69 | * The header buffer from which to parse.
70 | * @param offset
71 | * The offset into the buffer from which to parse.
72 | * @param length
73 | * The number of header bytes to parse.
74 | *
75 | * @return The integer value of the octal bytes.
76 | */
77 | public static int getOctalBytes(long value, byte[] buf, int offset, int length) {
78 | int idx = length - 1;
79 |
80 | buf[offset + idx] = 0;
81 | --idx;
82 | buf[offset + idx] = (byte) ' ';
83 | --idx;
84 |
85 | if (value == 0) {
86 | buf[offset + idx] = (byte) '0';
87 | --idx;
88 | } else {
89 | for (long val = value; idx >= 0 && val > 0; --idx) {
90 | buf[offset + idx] = (byte) ( (byte) '0' + (byte) ( val & 7 ) );
91 | val = val >> 3;
92 | }
93 | }
94 |
95 | for (; idx >= 0; --idx) {
96 | buf[offset + idx] = (byte) ' ';
97 | }
98 |
99 | return offset + length;
100 | }
101 |
102 | /**
103 | * Parse the checksum octal integer from a header buffer.
104 | *
105 | * @param value
106 | * @param buf
107 | * The header buffer from which to parse.
108 | * @param offset
109 | * The offset into the buffer from which to parse.
110 | * @param length
111 | * The number of header bytes to parse.
112 | * @return The integer value of the entry's checksum.
113 | */
114 | public static int getCheckSumOctalBytes(long value, byte[] buf, int offset, int length) {
115 | getOctalBytes( value, buf, offset, length );
116 | buf[offset + length - 1] = (byte) ' ';
117 | buf[offset + length - 2] = 0;
118 | return offset + length;
119 | }
120 |
121 | /**
122 | * Parse an octal long integer from a header buffer.
123 | *
124 | * @param value
125 | * @param buf
126 | * The header buffer from which to parse.
127 | * @param offset
128 | * The offset into the buffer from which to parse.
129 | * @param length
130 | * The number of header bytes to parse.
131 | *
132 | * @return The long value of the octal bytes.
133 | */
134 | public static int getLongOctalBytes(long value, byte[] buf, int offset, int length) {
135 | byte[] temp = new byte[length + 1];
136 | getOctalBytes( value, temp, 0, length + 1 );
137 | System.arraycopy( temp, 0, buf, offset, length );
138 | return offset + length;
139 | }
140 |
141 | }
142 |
--------------------------------------------------------------------------------
/src/org/xeustechnologies/jtar/Octal.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010 Xeus Technologies
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | *
16 | */
17 |
18 | package org.xeustechnologies.jtar;
19 |
20 | /**
21 | * @author Kamran Zafar
22 | *
23 | */
24 | public class Octal {
25 |
26 | /**
27 | * Parse an octal string from a header buffer. This is used for the file
28 | * permission mode value.
29 | *
30 | * @param header
31 | * The header buffer from which to parse.
32 | * @param offset
33 | * The offset into the buffer from which to parse.
34 | * @param length
35 | * The number of header bytes to parse.
36 | *
37 | * @return The long value of the octal string.
38 | */
39 | public static long parseOctal(byte[] header, int offset, int length) {
40 | long result = 0;
41 | boolean stillPadding = true;
42 |
43 | int end = offset + length;
44 | for( int i = offset; i < end; ++i ) {
45 | if( header[i] == 0 )
46 | break;
47 |
48 | if( header[i] == (byte) ' ' || header[i] == '0' ) {
49 | if( stillPadding )
50 | continue;
51 |
52 | if( header[i] == (byte) ' ' )
53 | break;
54 | }
55 |
56 | stillPadding = false;
57 |
58 | result = ( result << 3 ) + ( header[i] - '0' );
59 | }
60 |
61 | return result;
62 | }
63 |
64 | /**
65 | * Parse an octal integer from a header buffer.
66 | *
67 | * @param value
68 | * @param buf
69 | * The header buffer from which to parse.
70 | * @param offset
71 | * The offset into the buffer from which to parse.
72 | * @param length
73 | * The number of header bytes to parse.
74 | *
75 | * @return The integer value of the octal bytes.
76 | */
77 | public static int getOctalBytes(long value, byte[] buf, int offset, int length) {
78 | int idx = length - 1;
79 |
80 | buf[offset + idx] = 0;
81 | --idx;
82 | buf[offset + idx] = (byte) ' ';
83 | --idx;
84 |
85 | if( value == 0 ) {
86 | buf[offset + idx] = (byte) '0';
87 | --idx;
88 | } else {
89 | for( long val = value; idx >= 0 && val > 0; --idx ) {
90 | buf[offset + idx] = (byte) ( (byte) '0' + (byte) ( val & 7 ) );
91 | val = val >> 3;
92 | }
93 | }
94 |
95 | for( ; idx >= 0; --idx ) {
96 | buf[offset + idx] = (byte) ' ';
97 | }
98 |
99 | return offset + length;
100 | }
101 |
102 | /**
103 | * Parse the checksum octal integer from a header buffer.
104 | *
105 | * @param value
106 | * @param buf
107 | * The header buffer from which to parse.
108 | * @param offset
109 | * The offset into the buffer from which to parse.
110 | * @param length
111 | * The number of header bytes to parse.
112 | * @return The integer value of the entry's checksum.
113 | */
114 | public static int getCheckSumOctalBytes(long value, byte[] buf, int offset, int length) {
115 | getOctalBytes( value, buf, offset, length );
116 | buf[offset + length - 1] = (byte) ' ';
117 | buf[offset + length - 2] = 0;
118 | return offset + length;
119 | }
120 |
121 | /**
122 | * Parse an octal long integer from a header buffer.
123 | *
124 | * @param value
125 | * @param buf
126 | * The header buffer from which to parse.
127 | * @param offset
128 | * The offset into the buffer from which to parse.
129 | * @param length
130 | * The number of header bytes to parse.
131 | *
132 | * @return The long value of the octal bytes.
133 | */
134 | public static int getLongOctalBytes(long value, byte[] buf, int offset, int length) {
135 | byte[] temp = new byte[length + 1];
136 | getOctalBytes( value, temp, 0, length + 1 );
137 | System.arraycopy( temp, 0, buf, offset, length );
138 | return offset + length;
139 | }
140 |
141 | }
142 |
--------------------------------------------------------------------------------
/doc/_sources/changelog.txt:
--------------------------------------------------------------------------------
1 | .. _changelog:
2 |
3 | Changelog
4 | =========
5 |
6 | Pygame Subset for Android 0.9.6
7 | -------------------------------
8 |
9 | This release patches Python to work with .apk files distributed
10 | through the Amazon App Store, which are subtly different from
11 | standard apk files.
12 |
13 | This release fixes support for pre-2.3 Android devices.
14 |
15 |
16 | Pygame Subset for Android 0.9.5
17 | -------------------------------
18 |
19 | PGS4A now supports Expansion APKs when used in conjunction with the
20 | Google Play store. This increases the maximum package size from
21 | 50 MB to 2 GB. (Sideloaders or users of other app stores should
22 | continue to produce a monolithic package.)
23 |
24 | PGS4A is now based on a slightly modified python-for-android, which in
25 | turn was originally based on PGS4A.
26 |
27 | PGS4A now uses and requires Android 2.2 and OpenGL ES 2.
28 |
29 | `PyJNIus
48 |
84 |
101 |
102 |
49 |
83 |
50 |
51 |
52 |
59 |
79 |
80 |
81 |
82 | Python Module Index
53 | 54 |
55 | a
56 |
57 |
58 | | 61 | a | ||
| 65 | | 66 | android | 67 | |
| 70 | | 71 | android.assets | 72 | |
| 75 | | 76 | android.mixer | 77 | |
