Newer
Older
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
function target = overlay(this,west,east,south,north,varargin)
%KML.OVERLAY(west, east, south, north) Places the image file (specified by the pair
% attribute 'file','image.png') as a ground overlay in the kml file. The corners
% of the image are given by inputs west, east, south and north.
% To make the overlay transparent, change the alpha portion of the color parameter
% to a different hex value - eg.: 50% transparent, use KML.OVERLAY(...,'color','80FFFFFF')
%
% Copyright 2012 Rafael Fernandes de Oliveira (rafael@rafael.aero)
% $Revision: 2.3 $ $Date: 2012/09/05 08:00:00 $
target = struct('type','','id','');
[west,east,south,north] = this.checkUnit(west,east,south,north);
p = inputParser;
p.addRequired('west', @(a)isnumeric(a) && ~isempty(a) && numel(a)==1);
p.addRequired('east', @(a)isnumeric(a) && ~isempty(a) && numel(a)==1);
p.addRequired('south',@(a)isnumeric(a) && ~isempty(a) && numel(a)==1);
p.addRequired('north',@(a)isnumeric(a) && ~isempty(a) && numel(a)==1);
p.addParamValue('id',kml.getTempID('kml_overlay'),@ischar);
p.addParamValue('name','kml_overlay',@ischar);
p.addParamValue('description','',@ischar);
p.addParamValue('visibility',true,@islogical);
p.addParamValue('file','',@ischar);
p.addParamValue('viewBoundScale',1,@(a)isnumeric(a) && numel(a)==1);
p.addParamValue('color','FFFFFFFF',@(a)ischar(a) && numel(a)==8);
p.addParamValue('altitude',1,@(a)isnumeric(a) &&~isempty(a) && numel(a)==1);
p.addParamValue('rotation',0,@(a)isnumeric(a) &&~isempty(a) && numel(a)==1);
p.addParamValue('drawOrder',0,@(a)isnumeric(a) &&~isempty(a) && numel(a)==1);
p.addParamValue('altitudeMode','clampToGround',@(a)ismember(a,{'clampToGround','absolute'}));
p.addParamValue('timeStamp','',@ischar);
p.addParamValue('timeSpanBegin','',@ischar);
p.addParamValue('timeSpanEnd','',@ischar);
p.parse(west,east,south,north,varargin{:});
arg = p.Results;
if isempty(arg.file)
error('Missing file parameter')
end
arg.rotation = this.checkUnit(arg.rotation);
overlay = this.xml.createElement('GroundOverlay');
llbox = this.xml.createElement('LatLonBox');
icon = this.xml.createElement('Icon');
overlay.setAttribute('id',arg.id);
overlay.appendChild(this.textNode('name',arg.name));
overlay.appendChild(this.textNode('color',arg.color));
overlay.appendChild(this.textNode('visibility',num2str(arg.visibility)));
overlay.appendChild(this.textNode('description',arg.description));
overlay.appendChild(this.textNode('altitude',num2str(arg.altitude)));
overlay.appendChild(this.textNode('altitudeMode',arg.altitudeMode));
overlay.appendChild(this.textNode('drawOrder',num2str(arg.drawOrder)));
if ~isempty(arg.timeStamp)
timeStamp = this.xml.createElement('TimeStamp');
timeStamp.appendChild(this.textNode('when',arg.timeStamp));
overlay.appendChild(timeStamp);
elseif ~isempty(arg.timeSpanBegin) || ~isempty(arg.timeSpanEnd)
timeSpan = this.xml.createElement('TimeSpan');
if ~isempty(arg.timeSpanBegin)
timeSpan.appendChild(this.textNode('begin',arg.timeSpanBegin));
end
if ~isempty(arg.timeSpanEnd)
timeSpan.appendChild(this.textNode('end',arg.timeSpanEnd));
end
overlay.appendChild(timeSpan);
end
llbox.appendChild(this.textNode('north', num2str(north,16)));
llbox.appendChild(this.textNode('south', num2str(south,16)));
llbox.appendChild(this.textNode('east', num2str(east,16)));
llbox.appendChild(this.textNode('west', num2str(west,16)));
llbox.appendChild(this.textNode('rotation', num2str(arg.rotation)));
icon.appendChild(this.textNode('href',arg.file));
icon.appendChild(this.textNode('viewBoundScale',num2str(arg.viewBoundScale)));
overlay.appendChild(llbox);
overlay.appendChild(icon);
this.doc.appendChild(overlay);
target.id = arg.id;
target.type = 'GroundOverlay';
this.addIncludeFile(arg.file);
end