MultiImage.st
author Claus Gittinger <cg@exept.de>
Tue, 14 May 2019 09:46:14 +0200
changeset 4263 d349fa8d2945
parent 4202 a0ae08f456ba
child 4332 7c7749ad2f63
permissions -rw-r--r--
#UI_ENHANCEMENT by cg class: ToolApplicationModel class changed: #menuHelp #windowSpecForCommit
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4202
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
     1
"{ Encoding: utf8 }"
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
     2
1757
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     3
"
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     4
 COPYRIGHT (c) 2003 by eXept Software AG
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     5
              All Rights Reserved
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     6
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     7
 This software is furnished under a license and may be used
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     8
 only in accordance with the terms of that license and with the
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
     9
 inclusion of the above copyright notice.   This software may not
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    10
 be provided or otherwise made available to, or used by, any
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    11
 other person.  No title to or ownership of the software is
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    12
 hereby transferred.
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    13
"
1626
a987e8cf97b1 *** empty log message ***
Stefan Vogel <sv@exept.de>
parents: 1617
diff changeset
    14
"{ Package: 'stx:libview2' }"
1607
432b696242ea initial checkin
penk
parents:
diff changeset
    15
3454
4938f4baa0ef class: MultiImage
Claus Gittinger <cg@exept.de>
parents: 3324
diff changeset
    16
"{ NameSpace: Smalltalk }"
4938f4baa0ef class: MultiImage
Claus Gittinger <cg@exept.de>
parents: 3324
diff changeset
    17
1607
432b696242ea initial checkin
penk
parents:
diff changeset
    18
Object subclass:#MultiImage
432b696242ea initial checkin
penk
parents:
diff changeset
    19
	instanceVariableNames:'images'
432b696242ea initial checkin
penk
parents:
diff changeset
    20
	classVariableNames:''
432b696242ea initial checkin
penk
parents:
diff changeset
    21
	poolDictionaries:''
432b696242ea initial checkin
penk
parents:
diff changeset
    22
	category:'Graphics-Images'
432b696242ea initial checkin
penk
parents:
diff changeset
    23
!
432b696242ea initial checkin
penk
parents:
diff changeset
    24
1757
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    25
!MultiImage class methodsFor:'documentation'!
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    26
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    27
copyright
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    28
"
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    29
 COPYRIGHT (c) 2003 by eXept Software AG
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    30
              All Rights Reserved
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    31
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    32
 This software is furnished under a license and may be used
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    33
 only in accordance with the terms of that license and with the
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    34
 inclusion of the above copyright notice.   This software may not
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    35
 be provided or otherwise made available to, or used by, any
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    36
 other person.  No title to or ownership of the software is
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    37
 hereby transferred.
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    38
"
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    39
!
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    40
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    41
documentation
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    42
"
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    43
    A multiImage is an image which is drawn by drawing multiple images on top of each other.
4052
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
    44
    Typically, they are used to overlay additional information,
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
    45
    for example a stop-icon or a link-arrow over a fileType icon.
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
    46
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
    47
    try: 
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
    48
        MIMETypeIconLibrary iconForFile:'/foo/bar/baz.c' asFilename
1757
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    49
4053
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    50
    caveat:
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    51
        instances provide enough protocol to be shown as icon, label, etc.
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    52
        (i.e. provide a replacement for images and forms).
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    53
        However, not all tools are prepared for them not having mask, bits etc.
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    54
        Especially, the ImageEditor gets a bit confused and may fall into a debugger,
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    55
        if trying to edit one of my instances.
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
    56
        
1757
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    57
    [author:]
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    58
        Claus Gittinger
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    59
"
f6b3270f30d1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1708
diff changeset
    60
! !
1607
432b696242ea initial checkin
penk
parents:
diff changeset
    61
432b696242ea initial checkin
penk
parents:
diff changeset
    62
!MultiImage class methodsFor:'instance creation'!
432b696242ea initial checkin
penk
parents:
diff changeset
    63
432b696242ea initial checkin
penk
parents:
diff changeset
    64
images:imageCollection
432b696242ea initial checkin
penk
parents:
diff changeset
    65
    ^ self new images:imageCollection
432b696242ea initial checkin
penk
parents:
diff changeset
    66
! !
432b696242ea initial checkin
penk
parents:
diff changeset
    67
432b696242ea initial checkin
penk
parents:
diff changeset
    68
!MultiImage methodsFor:'accessing'!
432b696242ea initial checkin
penk
parents:
diff changeset
    69
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    70
device
2064
429bdc16e515 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1757
diff changeset
    71
    images isNil ifTrue:[^ nil].
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    72
    ^ images first device
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    73
!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    74
4202
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    75
graphicsDevice
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    76
    images isNil ifTrue:[^ nil].
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    77
    ^ images first graphicsDevice
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    78
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    79
    "Created: / 25-10-2018 / 12:40:16 / Claus Gittinger"
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    80
!
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    81
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    82
images
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    83
    "return the value of the instance variable 'images' (automatically generated)"
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    84
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    85
    ^ images
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    86
!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
    87
1607
432b696242ea initial checkin
penk
parents:
diff changeset
    88
images:something
432b696242ea initial checkin
penk
parents:
diff changeset
    89
    "set the value of the instance variable 'images' (automatically generated)"
432b696242ea initial checkin
penk
parents:
diff changeset
    90
432b696242ea initial checkin
penk
parents:
diff changeset
    91
    images := something.
4202
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    92
!
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    93
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    94
mask
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    95
    ^ nil
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    96
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
    97
    "Created: / 25-10-2018 / 12:35:09 / Claus Gittinger"
1607
432b696242ea initial checkin
penk
parents:
diff changeset
    98
! !
432b696242ea initial checkin
penk
parents:
diff changeset
    99
432b696242ea initial checkin
penk
parents:
diff changeset
   100
!MultiImage methodsFor:'displaying'!
432b696242ea initial checkin
penk
parents:
diff changeset
   101
432b696242ea initial checkin
penk
parents:
diff changeset
   102
displayOn:aGC x:x y:y opaque:opaque
432b696242ea initial checkin
penk
parents:
diff changeset
   103
    |doOpaque|
432b696242ea initial checkin
penk
parents:
diff changeset
   104
432b696242ea initial checkin
penk
parents:
diff changeset
   105
    doOpaque := opaque.
432b696242ea initial checkin
penk
parents:
diff changeset
   106
    images do:[:eachImage |
432b696242ea initial checkin
penk
parents:
diff changeset
   107
        eachImage displayOn:aGC x:x y:y opaque:doOpaque.
432b696242ea initial checkin
penk
parents:
diff changeset
   108
        doOpaque := false.
432b696242ea initial checkin
penk
parents:
diff changeset
   109
    ].
432b696242ea initial checkin
penk
parents:
diff changeset
   110
! !
432b696242ea initial checkin
penk
parents:
diff changeset
   111
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   112
!MultiImage methodsFor:'misc'!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   113
4202
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   114
asFormOn:aDevice
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   115
    |form|
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   116
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   117
    form := Form extent:(images first extent) depth:aDevice depth onDevice:aDevice.
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   118
    images do:[:eachImage |
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   119
        eachImage displayOn:form x:0 y:0 opaque:false.
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   120
    ].
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   121
    ^ form
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   122
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   123
    "Created: / 25-10-2018 / 12:38:18 / Claus Gittinger"
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   124
!
a0ae08f456ba #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4053
diff changeset
   125
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   126
clearMaskedPixels
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   127
    images := images do:[:eachImage | eachImage clearMaskedPixels].
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   128
    ^ self
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   129
!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   130
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   131
onDevice:device
1654
0ced7b571123 care for nil-images
Claus Gittinger <cg@exept.de>
parents: 1626
diff changeset
   132
    images := images collect:[:eachImage | (eachImage onDevice:device) ? eachImage].
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   133
    ^ self
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   134
! !
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   135
3454
4938f4baa0ef class: MultiImage
Claus Gittinger <cg@exept.de>
parents: 3324
diff changeset
   136
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   137
!MultiImage methodsFor:'queries'!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   138
1708
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   139
ascentOn:aGC
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   140
    "I will not draw myself above the baseline"
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   141
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   142
    ^ 0
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   143
!
43566f862a4d ascentOn:
Claus Gittinger <cg@exept.de>
parents: 1654
diff changeset
   144
3324
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   145
depth
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   146
    ^ images inject:0 into:[:maxSoFar :eachImage | maxSoFar max:eachImage depth].
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   147
!
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   148
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   149
extent
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   150
    ^ self width @ self height
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   151
!
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   152
1614
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   153
height  
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   154
    ^ images inject:0 into:[:maxSoFar :eachImage | maxSoFar max:eachImage height].
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   155
!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   156
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   157
isImageOrForm
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   158
    ^ true
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   159
!
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   160
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   161
width
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   162
    ^ images inject:0 into:[:maxSoFar :eachImage | maxSoFar max:eachImage width].
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   163
! !
b147a4fd04cf defined source container
penk
parents: 1607
diff changeset
   164
1607
432b696242ea initial checkin
penk
parents:
diff changeset
   165
!MultiImage class methodsFor:'documentation'!
432b696242ea initial checkin
penk
parents:
diff changeset
   166
432b696242ea initial checkin
penk
parents:
diff changeset
   167
version
4052
3e893a2cc401 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3454
diff changeset
   168
    ^ '$Header$'
4053
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
   169
!
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
   170
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
   171
version_CVS
f2c550e0c24e #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4052
diff changeset
   172
    ^ '$Header$'
1607
432b696242ea initial checkin
penk
parents:
diff changeset
   173
! !
3324
b3c333344810 class: MultiImage
Stefan Vogel <sv@exept.de>
parents: 2064
diff changeset
   174