finish top level android directory files

system_fonts.odin

@@ -0,0 +1,86 @@
+//+build android
+package android
+
+foreign import android "system:android"
+
+/**
+ * @file system_fonts.h
+ * @brief Provides the system font configurations.
+ *
+ * These APIs provides the list of system installed font files with additional metadata about the
+ * font.
+ *
+ * The ASystemFontIterator_open method will give you an iterator which can iterate all system
+ * installed font files as shown in the following example.
+ *
+ * \code{.cpp}
+ *   ASystemFontIterator* iterator = ASystemFontIterator_open();
+ *   ASystemFont* font = NULL;
+ *
+ *   while ((font = ASystemFontIterator_next(iterator)) != nullptr) {
+ *       // Look if the font is your desired one.
+ *       if (ASystemFont_getWeight(font) == 400 && !ASystemFont_isItalic(font)
+ *           && ASystemFont_getLocale(font) == NULL) {
+ *           break;
+ *       }
+ *       ASystemFont_close(font);
+ *   }
+ *   ASystemFontIterator_close(iterator);
+ *
+ *   int fd = open(ASystemFont_getFontFilePath(font), O_RDONLY);
+ *   int collectionIndex = ASystemFont_getCollectionINdex(font);
+ *   std::vector<std::pair<uint32_t, float>> variationSettings;
+ *   for (size_t i = 0; i < ASystemFont_getAxisCount(font); ++i) {
+ *       variationSettings.push_back(std::make_pair(
+ *           ASystemFont_getAxisTag(font, i),
+ *           ASystemFont_getAxisValue(font, i)));
+ *   }
+ *   ASystemFont_close(font);
+ *
+ *   // Use this font for your text rendering engine.
+ *
+ * \endcode
+ *
+ * Available since API level 29.
+ */
+
+/**
+ * ASystemFontIterator provides access to the system font configuration.
+ *
+ * ASystemFontIterator is an iterator for all available system font settings.
+ * This iterator is not a thread-safe object. Do not pass this iterator to other threads.
+ */
+ASystemFontIterator :: struct{}
+
+foreign android {
+	/**
+	 * Create a system font iterator.
+	 *
+	 * Use ASystemFont_close() to close the iterator.
+	 *
+	 * Available since API level 29.
+	 *
+	 * \return a pointer for a newly allocated iterator, nullptr on failure.
+	 */
+	ASystemFontIterator_open :: proc() -> ^ASystemFontIterator ---
+
+	/**
+	* Close an opened system font iterator, freeing any related resources.
+	*
+	* Available since API level 29.
+	*
+	* \param iterator a pointer of an iterator for the system fonts. Do nothing if NULL is passed.
+	*/
+	ASystemFontIterator_close :: proc(iterator: ^ASystemFontIterator) ---
+
+	/**
+	* Move to the next system font.
+	*
+	* Available since API level 29.
+	*
+	* \param iterator an iterator for the system fonts. Passing NULL is not allowed.
+	* \return a font. If no more font is available, returns nullptr. You need to release the returned
+	*         font by ASystemFont_close when it is no longer needed.
+	*/
+	ASystemFontIterator_next :: proc(iterator: ^ASystemFontIterator) -> ^AFont ---
+}