111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/* 211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Copyright (C) 2010 The Android Open Source Project 311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * 411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Licensed under the Apache License, Version 2.0 (the "License"); 511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * you may not use this file except in compliance with the License. 611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * You may obtain a copy of the License at 711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * 811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * http://www.apache.org/licenses/LICENSE-2.0 911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * 1011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Unless required by applicable law or agreed to in writing, software 1111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * distributed under the License is distributed on an "AS IS" BASIS, 1211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * See the License for the specific language governing permissions and 1411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * limitations under the License. 1511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 1611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 1711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#ifndef ANDROID_CONFIGURATION_H 1811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#define ANDROID_CONFIGURATION_H 1911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 2011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#include <android/asset_manager.h> 2111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 2211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#ifdef __cplusplus 2311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertextern "C" { 2411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#endif 2511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 2611cd02dfb91661c65134cac258cf5924270e9d2Dan Albertstruct AConfiguration; 2711cd02dfb91661c65134cac258cf5924270e9d2Dan Alberttypedef struct AConfiguration AConfiguration; 2811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 2911cd02dfb91661c65134cac258cf5924270e9d2Dan Albertenum { 3011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_ORIENTATION_ANY = 0x0000, 3111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_ORIENTATION_PORT = 0x0001, 3211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_ORIENTATION_LAND = 0x0002, 3311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_ORIENTATION_SQUARE = 0x0003, 3411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 3511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_TOUCHSCREEN_ANY = 0x0000, 3611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_TOUCHSCREEN_NOTOUCH = 0x0001, 3711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_TOUCHSCREEN_STYLUS = 0x0002, 3811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_TOUCHSCREEN_FINGER = 0x0003, 3911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 4011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_DEFAULT = 0, 4111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_LOW = 120, 4211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_MEDIUM = 160, 4311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_TV = 213, 4411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_HIGH = 240, 4511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_XHIGH = 320, 4611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_XXHIGH = 480, 4711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_XXXHIGH = 640, 4811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_ANY = 0xfffe, 4911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY_NONE = 0xffff, 5011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 5111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD_ANY = 0x0000, 5211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD_NOKEYS = 0x0001, 5311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD_QWERTY = 0x0002, 5411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD_12KEY = 0x0003, 5511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 5611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION_ANY = 0x0000, 5711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION_NONAV = 0x0001, 5811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION_DPAD = 0x0002, 5911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION_TRACKBALL = 0x0003, 6011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION_WHEEL = 0x0004, 6111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 6211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYSHIDDEN_ANY = 0x0000, 6311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYSHIDDEN_NO = 0x0001, 6411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYSHIDDEN_YES = 0x0002, 6511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYSHIDDEN_SOFT = 0x0003, 6611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 6711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVHIDDEN_ANY = 0x0000, 6811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVHIDDEN_NO = 0x0001, 6911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVHIDDEN_YES = 0x0002, 7011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 7111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENSIZE_ANY = 0x00, 7211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENSIZE_SMALL = 0x01, 7311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENSIZE_NORMAL = 0x02, 7411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENSIZE_LARGE = 0x03, 7511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENSIZE_XLARGE = 0x04, 7611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 7711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENLONG_ANY = 0x00, 7811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENLONG_NO = 0x1, 7911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREENLONG_YES = 0x2, 8011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 8111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_ANY = 0x00, 8211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_NORMAL = 0x01, 8311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_DESK = 0x02, 8411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_CAR = 0x03, 8511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_TELEVISION = 0x04, 8611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_APPLIANCE = 0x05, 8711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_TYPE_WATCH = 0x06, 8811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 8911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_NIGHT_ANY = 0x00, 9011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_NIGHT_NO = 0x1, 9111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE_NIGHT_YES = 0x2, 9211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 9311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREEN_WIDTH_DP_ANY = 0x0000, 9411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 9511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREEN_HEIGHT_DP_ANY = 0x0000, 9611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 9711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY = 0x0000, 9811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 9911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_LAYOUTDIR_ANY = 0x00, 10011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_LAYOUTDIR_LTR = 0x01, 10111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_LAYOUTDIR_RTL = 0x02, 10211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 10311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_MCC = 0x0001, 10411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_MNC = 0x0002, 10511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_LOCALE = 0x0004, 10611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_TOUCHSCREEN = 0x0008, 10711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD = 0x0010, 10811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_KEYBOARD_HIDDEN = 0x0020, 10911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_NAVIGATION = 0x0040, 11011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_ORIENTATION = 0x0080, 11111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_DENSITY = 0x0100, 11211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREEN_SIZE = 0x0200, 11311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_VERSION = 0x0400, 11411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SCREEN_LAYOUT = 0x0800, 11511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_UI_MODE = 0x1000, 11611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_SMALLEST_SCREEN_SIZE = 0x2000, 11711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_LAYOUTDIR = 0x4000, 11811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 11911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert ACONFIGURATION_MNC_ZERO = 0xffff, 12011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert}; 12111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 12211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 12311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Create a new AConfiguration, initialized with no values set. 12411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 12511cd02dfb91661c65134cac258cf5924270e9d2Dan AlbertAConfiguration* AConfiguration_new(); 12611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 12711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 12811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Free an AConfiguration that was previously created with 12911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * AConfiguration_new(). 13011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 13111cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_delete(AConfiguration* config); 13211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 13311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 13411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Create and return a new AConfiguration based on the current configuration in 13511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * use in the given AssetManager. 13611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 13711cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_fromAssetManager(AConfiguration* out, AAssetManager* am); 13811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 13911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 14011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Copy the contents of 'src' to 'dest'. 14111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 14211cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_copy(AConfiguration* dest, AConfiguration* src); 14311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 14411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 14511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current MCC set in the configuration. 0 if not set. 14611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 14711cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getMcc(AConfiguration* config); 14811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 14911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 15011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current MCC in the configuration. 0 to clear. 15111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 15211cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setMcc(AConfiguration* config, int32_t mcc); 15311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 15411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 15511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current MNC set in the configuration. 0 if not set. 15611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 15711cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getMnc(AConfiguration* config); 15811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 15911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 16011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current MNC in the configuration. 0 to clear. 16111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 16211cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setMnc(AConfiguration* config, int32_t mnc); 16311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 16411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 16511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current language code set in the configuration. The output will 16611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * be filled with an array of two characters. They are not 0-terminated. If 16711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * a language is not set, they will be 0. 16811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 16911cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_getLanguage(AConfiguration* config, char* outLanguage); 17011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 17111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 17211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current language code in the configuration, from the first two 17311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * characters in the string. 17411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 17511cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setLanguage(AConfiguration* config, const char* language); 17611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 17711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 17811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current country code set in the configuration. The output will 17911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * be filled with an array of two characters. They are not 0-terminated. If 18011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * a country is not set, they will be 0. 18111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 18211cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_getCountry(AConfiguration* config, char* outCountry); 18311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 18411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 18511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current country code in the configuration, from the first two 18611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * characters in the string. 18711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 18811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setCountry(AConfiguration* config, const char* country); 18911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 19011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 19111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_ORIENTATION_* set in the configuration. 19211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 19311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getOrientation(AConfiguration* config); 19411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 19511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 19611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current orientation in the configuration. 19711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 19811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setOrientation(AConfiguration* config, int32_t orientation); 19911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 20011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 20111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_TOUCHSCREEN_* set in the configuration. 20211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 20311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getTouchscreen(AConfiguration* config); 20411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 20511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 20611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current touchscreen in the configuration. 20711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 20811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setTouchscreen(AConfiguration* config, int32_t touchscreen); 20911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 21011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 21111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_DENSITY_* set in the configuration. 21211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 21311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getDensity(AConfiguration* config); 21411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 21511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 21611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current density in the configuration. 21711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 21811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setDensity(AConfiguration* config, int32_t density); 21911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 22011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 22111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_KEYBOARD_* set in the configuration. 22211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 22311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getKeyboard(AConfiguration* config); 22411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 22511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 22611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current keyboard in the configuration. 22711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 22811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setKeyboard(AConfiguration* config, int32_t keyboard); 22911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 23011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 23111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_NAVIGATION_* set in the configuration. 23211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 23311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getNavigation(AConfiguration* config); 23411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 23511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 23611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current navigation in the configuration. 23711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 23811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setNavigation(AConfiguration* config, int32_t navigation); 23911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 24011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 24111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_KEYSHIDDEN_* set in the configuration. 24211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 24311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getKeysHidden(AConfiguration* config); 24411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 24511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 24611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current keys hidden in the configuration. 24711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 24811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setKeysHidden(AConfiguration* config, int32_t keysHidden); 24911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 25011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 25111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_NAVHIDDEN_* set in the configuration. 25211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 25311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getNavHidden(AConfiguration* config); 25411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 25511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 25611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current nav hidden in the configuration. 25711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 25811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setNavHidden(AConfiguration* config, int32_t navHidden); 25911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 26011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 26111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current SDK (API) version set in the configuration. 26211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 26311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getSdkVersion(AConfiguration* config); 26411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 26511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 26611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current SDK version in the configuration. 26711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 26811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setSdkVersion(AConfiguration* config, int32_t sdkVersion); 26911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 27011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 27111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_SCREENSIZE_* set in the configuration. 27211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 27311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getScreenSize(AConfiguration* config); 27411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 27511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 27611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current screen size in the configuration. 27711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 27811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setScreenSize(AConfiguration* config, int32_t screenSize); 27911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 28011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 28111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_SCREENLONG_* set in the configuration. 28211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 28311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getScreenLong(AConfiguration* config); 28411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 28511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 28611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current screen long in the configuration. 28711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 28811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setScreenLong(AConfiguration* config, int32_t screenLong); 28911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 29011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 29111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_UI_MODE_TYPE_* set in the configuration. 29211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 29311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getUiModeType(AConfiguration* config); 29411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 29511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 29611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current UI mode type in the configuration. 29711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 29811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setUiModeType(AConfiguration* config, int32_t uiModeType); 29911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 30011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 30111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current ACONFIGURATION_UI_MODE_NIGHT_* set in the configuration. 30211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 30311cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getUiModeNight(AConfiguration* config); 30411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 30511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 30611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the current UI mode night in the configuration. 30711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 30811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setUiModeNight(AConfiguration* config, int32_t uiModeNight); 30911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 31011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 31111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current configuration screen width in dp units, or 31211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * ACONFIGURATION_SCREEN_WIDTH_DP_ANY if not set. 31311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 31411cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getScreenWidthDp(AConfiguration* config); 31511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 31611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 31711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the configuration's current screen width in dp units. 31811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 31911cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setScreenWidthDp(AConfiguration* config, int32_t value); 32011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 32111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 32211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the current configuration screen height in dp units, or 32311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * ACONFIGURATION_SCREEN_HEIGHT_DP_ANY if not set. 32411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 32511cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getScreenHeightDp(AConfiguration* config); 32611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 32711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 32811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the configuration's current screen width in dp units. 32911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 33011cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setScreenHeightDp(AConfiguration* config, int32_t value); 33111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 33211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 33311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the configuration's smallest screen width in dp units, or 33411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY if not set. 33511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 33611cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getSmallestScreenWidthDp(AConfiguration* config); 33711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 33811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 33911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the configuration's smallest screen width in dp units. 34011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 34111cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setSmallestScreenWidthDp(AConfiguration* config, int32_t value); 34211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 34311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 34411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Return the configuration's layout direction, or 34511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * ACONFIGURATION_LAYOUTDIR_ANY if not set. 34611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 34711cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_getLayoutDirection(AConfiguration* config); 34811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 34911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 35011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Set the configuration's layout direction. 35111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 35211cd02dfb91661c65134cac258cf5924270e9d2Dan Albertvoid AConfiguration_setLayoutDirection(AConfiguration* config, int32_t value); 35311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 35411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 35511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Perform a diff between two configurations. Returns a bit mask of 35611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * ACONFIGURATION_* constants, each bit set meaning that configuration element 35711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * is different between them. 35811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 35911cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_diff(AConfiguration* config1, AConfiguration* config2); 36011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 36111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 36211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Determine whether 'base' is a valid configuration for use within the 36311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * environment 'requested'. Returns 0 if there are any values in 'base' 36411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * that conflict with 'requested'. Returns 1 if it does not conflict. 36511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 36611cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_match(AConfiguration* base, AConfiguration* requested); 36711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 36811cd02dfb91661c65134cac258cf5924270e9d2Dan Albert/** 36911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * Determine whether the configuration in 'test' is better than the existing 37011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * configuration in 'base'. If 'requested' is non-NULL, this decision is based 37111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * on the overall configuration given there. If it is NULL, this decision is 37211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * simply based on which configuration is more specific. Returns non-0 if 37311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * 'test' is better than 'base'. 37411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * 37511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * This assumes you have already filtered the configurations with 37611cd02dfb91661c65134cac258cf5924270e9d2Dan Albert * AConfiguration_match(). 37711cd02dfb91661c65134cac258cf5924270e9d2Dan Albert */ 37811cd02dfb91661c65134cac258cf5924270e9d2Dan Albertint32_t AConfiguration_isBetterThan(AConfiguration* base, AConfiguration* test, 37911cd02dfb91661c65134cac258cf5924270e9d2Dan Albert AConfiguration* requested); 38011cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 38111cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#ifdef __cplusplus 38211cd02dfb91661c65134cac258cf5924270e9d2Dan Albert}; 38311cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#endif 38411cd02dfb91661c65134cac258cf5924270e9d2Dan Albert 38511cd02dfb91661c65134cac258cf5924270e9d2Dan Albert#endif // ANDROID_CONFIGURATION_H 386