blob: 3a24e43c0d92fc4c9acaf671238d4c0be3adf904 (
plain)
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
|
/*
* MaplyBillboard.h
* WhirlyGlobeComponent
*
* Created by Steve Gifford on 10/28/13.
* Copyright 2011-2022 mousebird consulting
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
#import <UIKit/UIKit.h>
#import <WhirlyGlobeMaplyComponent/MaplyCoordinate.h>
#import <WhirlyGlobeMaplyComponent/MaplyScreenObject.h>
/**
A billboard is tied to a specific point, but rotates to face the user.
The billboard object represents a rectangle which is rooted at a specific point, but will rotate to face the user. These are typically used in 3D, when the globe or map has a tilt. They make little sense in 2D.
*/
@interface MaplyBillboard : NSObject
/**
The point this billboard is rooted at.
The x and y coordinates are radians. The z coordinate is in meters.
*/
@property (nonatomic) MaplyCoordinate3d center;
/// Set if you want to select these
@property (nonatomic) bool selectable;
/// The 2D polygonal description of what the billboard should be
@property (nonatomic,strong) MaplyScreenObject * __nullable screenObj;
/**
Vertex attributes to apply to this billboard.
MaplyVertexAttribute objects are passed all the way to the shader. Read that page for details on what they do.
The array of vertex attributes provided here will be copied onto all the vertices we create for the shader. This means you can use these to do things for a single billboard in your shader.
*/
@property (nonatomic,strong) NSArray * __nullable vertexAttributes;
/**
User data object for selection
When the user selects a feature and the developer gets it in their delegate, this is an object they can use to figure out what the screen label means to them.
*/
@property (nonatomic,strong) id __nullable userObject;
/**
Initialize with a single image, a given background and a size.
This will create a simple billboard with a single image pasted on it.
@param texture This can either be a UIImage or a MaplyTexture.
@param color Color for the polygon that makes up the billboard.
@param size Size of the billboard in display space.
*/
- (nullable instancetype)initWithImage:(id __nonnull)texture color:(UIColor * __nonnull)color size:(CGSize)size;
@end
|
