סקירה כללית
GMSSyncTileLayer הוא סוג משנה מופשט של GMSTileLayer שמספק ממשק סנכרון ליצירת נתונים של אריחי תמונה.
מקבלת בירושה את GMSTileLayer.
פונקציות של חברי מועדון | |
| (nullable UIImage *) | - tileForX:y:zoom: |
| בהתאם ל-requestTileForX:y:zoom:receiver: ב-GMSTileLayer, אבל מספק ממשק סינכרוני להחזרת משבצות. | |
| (void) | – requestTileForX:y:zoom:receiver: |
| requestTileForX:y:zoom:receiver: יוצר אריחי תמונה עבור GMSTileOverlay. | |
| (void) | – clearTileCache |
| מנקה את המטמון כדי לבקש שוב את כל המשבצות. | |
נכסים | |
| GMSMapView * | מפה |
| המפה שבה מוצג ה-GMSTileOverlay הזה. | |
| int | zIndex |
שכבות משבצות גבוהות יותר של ערך zIndex ישורטטו מעל לשכבות-על ושכבות-על של אריחים עם ערך zIndex. | |
| NSInteger | tileSize |
| ההגדרה קובעת את מספר הפיקסלים (לא נקודות) שבהם תמונות המשבצת שהוחזרו יעדיפו להציג. | |
| float | שקיפות |
| מציין את השקיפות של שכבת המשבצת. | |
| בוליאני | fadeIn |
| מציינת אם המשבצות צריכות להתעמעם. | |
מסמכי תיעוד לגבי פונקציות של חברים
| - (nullable UIImage *) tileForX: | (NSUInteger) | x | |
| y: | (NSUInteger) | שנה | |
| זום: | (NSUInteger) | שינוי מרחק התצוגה | |
בהתאם ל-requestTileForX:y:zoom:receiver: ב-GMSTileLayer, אבל מספק ממשק סינכרוני להחזרת משבצות.
השיטה הזו עלולה לחסום או לבצע עבודה בדרך אחרת, והיא לא מופעלת ב-thread הראשי.
אפשר לבצע קריאות לשיטה הזו גם מכמה שרשורים, כך שההטמעות חייבות להיות בטוחות לשרשורים.
| - (ביטול) requestTileForX: | (NSUInteger) | x | |
| y: | (NSUInteger) | שנה | |
| זום: | (NSUInteger) | שינוי מרחק התצוגה | |
| נמען: | (id< GMSTileReceiver >) | הנמען | |
requestTileForX:y:zoom:receiver: יוצר אריחי תמונה עבור GMSTileOverlay.
מחלקות משנה צריכות לשנות אותו. האריח עבור x, y ו-zoom _חייב_ להישלח מאוחר יותר אל receiver.
יש לציין kGMSTileLayerNoTile אם אין אריח זמין עבור מיקום זה, או להזין nil אם אירעה שגיאה זמנית וייתכן שכרטיס מידע יהיה זמין בשלב מאוחר יותר.
קריאות לשיטה הזו יתבצעו ב-thread הראשי. בקטע GMSSyncTileLayer מוסבר על מחלקת בסיס שמטמיעה שכבת אריח חוסמת שלא רצה ב-thread הראשי של האפליקציה.
| - (ריק) clearTileCache |
מנקה את המטמון כדי לבקש שוב את כל המשבצות.
תיעוד נכס
- (GMSMapView*) מפה [read, write, assign, inherited] |
המפה שבה מוצג ה-GMSTileOverlay הזה.
הגדרת המאפיין הזה תוסיף את השכבה למפה. הגדרת הערך nil תסיר את השכבה הזו מהמפה. שכבה יכולה להיות פעילה במפה אחת לכל היותר בכל זמן נתון.
- (int) zIndex [read, write, assign, inherited] |
שכבות משבצות גבוהות יותר של ערך zIndex ישורטטו מעל לשכבות-על ושכבות-על של אריחים עם ערך zIndex.
ערכים שווים מובילים לסדר שרטוט לא מוגדר.
- (NSInteger) tileSize [read, write, assign, inherited] |
ההגדרה קובעת את מספר הפיקסלים (לא נקודות) שבהם תמונות המשבצת שהוחזרו יעדיפו להציג.
לקבלת התוצאות הטובות ביותר, מומלץ לציין את אורך הקצה של המשבצות המותאמות אישית. ברירת המחדל היא 256, שהוא הגודל המסורתי של קטעי המפה של מפות Google.
ערכים נמוכים מ-128 נקודות (לדוגמה, 256 פיקסלים במכשירים עם מסך רטינה) עלולים להניב ביצועים נמוכים והם לא מומלצים.
לדוגמה, ייתכן שמפתח יישומים ירצה לספק אריחי רטינה (אורך קצה של 512 פיקסלים) במכשירי רטינה, כדי לשמור על אותו מספר משבצות לצפייה כמו ערך ברירת המחדל של 256 שמתקבל במכשיר שאינו רטינה.
- (float) שקיפות [read, write, assign, inherited] |
מציין את השקיפות של שכבת המשבצת.
הדבר מספק מכפיל לערוץ האלפא של תמונות משבצות.
- (BOOL) fadeIn [read, write, assign, inherited] |
מציינת אם המשבצות צריכות להתעמעם.
ברירת המחדל היא 'כן'.