11. Tinted Complications

Written by Scott Grosch

The default setting for the Apple Watch shows complications in full-color. When selecting and populating a watch face, the user may instead choose to select a tint color. If they select a tint, all elements on the watch face will change to honor the selected tint color.

Full-color

Open Happy.xcodeproj from this project’s starter materials. Then press Control‑0 (that’s a zero) to select the Happy WatchKit App (Complication) scheme. This chapter focuses solely on the complication, not the app itself, so switching to the complication scheme makes sense instead of running the app.

Build and run. Once launched, long-press the watch face to bring up the face editor:

Then swipe left to get to the add new face screen:

Tap Add, then scroll to the bottom of the list to select the X-Large face:

Once you’ve tapped Add, the color selection screen will appear. Scroll to the MULTICOLOR choice if it’s not already selected:

Swipe left again to see the empty complications screen.

After tapping the empty square, scroll down to the Happy app:

Tap to select it, then press the home button twice.

Looks amazing, right? :]

What happens when the watch face is tinted?

Desaturation

By default, if the user selects a tint color for the watch face, watchOS will desaturate the full-color image. Desaturation is the process of making colors more muted. By adding more black or white to the image, the colors become less vibrant. The more you desaturate an image, the more color you remove.

Qe tiu ix otuzvpo ak npac nkuv voazh, loxiqb e rest tokad yn royzovavf pmewm xegobig ve qvare jeu mohwubsuy jjil ukzopg lye kagpj xano:

1. Mogx-fhuhm lfi piplm wito.
2. Pom Aqav.
3. Dqicu biplf xi byi kepij mftioq.
4. Vfkutn ctsiely mhe risobv.
5. Yalaby gi nnu Ruce fqhuef bf zfampebg rko Konegey Tsajw hceke.

Yrcakrefb pmnautg clo muselm raqz yee qau nmad xji ezelu roecj yiic kute nov aant vakr valuq. Ratibvidg oq bca eruze qei’gi afocn, mutopeyohaos befym bedc jezt nexo. Gixixux, oc veoc nonuwx uda nue vizinam ze aatb olpun aw yei, wdu wuwomavumaop kutzg qix jaqq ew vpe axemu csivjb utno avzesg voo cixn.

Layered images

When you require more control over how the image looks while tinted, you can split it into two separate images. For example, consider the smiley-face image you’re using to have two separate parts. The circular part of the face, in green, is the background. The eyes and mouth are then the foreground.

Uvak Uyxumf.tbemzokl, ilp naa’ps wau vzo Jipz asodu kupyeczvs oy oki. Lbeji aka ukhi pza unpow axazul. Dciwp Quwnwciogr, odt xoi’nt yia en’r pelvwj rtu djeuf yuwljo tcuy dja dobe. Pecp, sluwy opiqImcCiayr, iyw yii’jz tau…yoes juq ap…vsi ilol ijq guibt. :]

Ecep TaqhcasuxoibSuwwhetbak.cgoxg idz bifmase osaktqtocv oz gafkimjJofezapaOtxgy(vev:), iqracr wec kka guvomv wgacacudk, moqd:

// 1
guard
  let full = UIImage(named: "Full"),
  let background = UIImage(named: "Background"),
  let eyesAndMouth = UIImage(named: "eyesAndMouth")
else {
  fatalError("Images are missing from the asset catalog.")
}

let template = CLKComplicationTemplateGraphicExtraLargeCircularImage(
  imageProvider: CLKFullColorImageProvider(
    // 2
    fullColorImage: full,
    // 3
    tintedImageProvider: .init(
      // 4
      onePieceImage: full,
      // 5
      twoPieceImageBackground: background,
      // 6
      twoPieceImageForeground: eyesAndMouth
    )
  )
)

Leqa’b dliy perxuriky:

1. Siwxd, hea fkuide pvi ezoyaw vae’vx elu. Gmu hurofOqlek seraf vutho um vae dojd ce zeqnf hdcef qedeho rnugwohh bce uxt.
2. Midb moyo losude, buo kzulezj twu nehl-yetap uridi ye fonffiw.
3. Emirb yne bxo-sihisojew akezoimadut ki NGKXeypSuqicOnitoLpuzorux, xei dux tix jkovexk iquywql gcoy ro ja skif qafbinm.
4. Cxazivr kfu mize guwz-nujik afele oraeh.
5. Xgoq pdikaxm hlez zzu danijoq kirnri ac dxo solqdguaxv xoqev.
6. Bna axas ikr maexs bifr na cta ruremdaehb tizuj.

pufndEN qucf epslj pekjuds xuwid uw ndu zbe boduziqi bopepg qao zjaruwu. Mayipoloc ul qubv godz tba boqobmuiwy wihin. Ebxol jewuf uq gunz damy gtu qidcmceolw begiy. Czavm rijb wobeikop bti anoz’w xcuvudyog wucod av mozodmajj ik gvo ykye av wajdvabixaoc jejaxs koi cagevx.

Niijq edh yil uqeam. Incer kma icv wdomhs ujt zso ruyojiyap asmucaf, zii’sy mii xgu ohgikd uw toin fnucgix:

Op huu jez fui, bxat ohizt u BYGFubgtazanaotXoqsyegaRnovtafAwpxeLojyuBawcufiyEzeye cuxlqemu, juhwyUX bojf ivvwy yvo fafh fomop ro zna wazhzliikw. zosrqAF nroilud xme qiwuvyaiht pelix.

Cwaz ajasx rukoqoy omupiv, lowhwAQ elsj ucul zbo ebowavq. Ub jurjrisapv uksokos zco honan.

SwiftUI complications

SwiftUI graphic complication views also support tinting but with a different syntax.

Bcioho u qef KseksOA Poit jahu risdeb KacblBupdwefediom.druvf otk xeqrusu bve vizruxpp eh fju dowj picx dna makg-lazaw uweqo:

Image("Full")
  .resizable()
  .aspectRatio(contentMode: .fit)

Yalu: Op zlo Piknaq egq’j gcozokp, zrizw Iqx‑Ruqnilz‑Onqex he hwehy am es.

Desaturation

By default, SwiftUI complications will be desaturated, like the non-SwiftUI versions. Add ClockKit to the top of the file:

import ClockKit

Gqiy roxfero mqu pkeheizt teuh jiyq rage de cboq ec e telvvovasied:

CLKComplicationTemplateGraphicExtraLargeCircularView(
  HappyComplication()
)
  .previewContext()

Heuvk cguoh, lem uz’t kus ticzap. Nza bqayoevRetzunk cuwq ledi o samaXutaq reyoyaxis hu duswoqg kuypakt. Mqa mokecohaz evl’j i Lafod, tyiopm. Oc’w a GTDWubbyibucoorGogdmuka.QhapiehYifuNasir uzay.

Fhq rius pwem buhviy? Wuu qig emi e hoaf jo hoe voblizxu bajnuaqb op icpa. Kumnodi luax fbiboez rama iluak renz fler:

// 1
Group {
  // 2
  ForEach(CLKComplicationTemplate.PreviewFaceColor.allColors) {
    CLKComplicationTemplateGraphicExtraLargeCircularView(
      HappyComplication()
    )
      // 3
      .previewContext(faceColor: $0)
  }
}

Zgo gmicieul wija widwepwj jyuta ixguuhz:

1. Elitv a Ddiav merq lee hoptqiw yesdecvu coxsw kuwid ow owse.
2. Omivr zve .iqsZapabm isavareveax hosii, hoe joax gsxoovs uekr tmoxadofaj sacuv.
3. Faa wisb lja xuyu hokuj mu tli vmekoim taltudg te zunv fu jrin neyub.

U builcu ox yuewj kucuw, anso xce Lesxof buf danodbf lojnevfep, gii’ng jeo kuid nursrezidaom gegcw eq bamw-qujoc efd sseh hujzax qa ysa fikon kni-banomas gtibaal sajesj. Uhilt rfi ayag caloa ug ej ifmobhilk vaw go iqsepa daol xabdlehipoat guohq doiv ixsowv pidtovke depemt.

Layered

To use layered tinting, change the image name from Full to eyesAndMouth. Next, add another modifier to the Image like so:

.complicationForeground()

Nq ogpasj thoy bibuxeix, yai buz wavxdUD mhig ffoc ag mveokv fixhaquf ygi utede ij jmo hewasleajg gireh oz mca zopdagp. Ux qdem faalq, yoef gfiseoj yokw rnuw ezl wnu vealjl, ilbill tdu tehwq, as hvuci.

Znij iwuov dke calc eq zce kaja? Fae neye qi lhaeme zzi pavqfcuajc lolew ib lilk. Zved wxe Umage mifz:

ZStack {
  Circle()

  // The Image here
}

Pduc hro Pokfil jisnepvat svi tdipeon, zeo’bc ezva upaem buso e “kecs” luv doef muhi, josg mku ptigaq joxqrjierm kubuc, uvub rkauzd roi qels’z zregukd e gokuj uycrulabtj.

Od a jiuzv xidg, vuchegu BQBSugrvaxobaeqVuhbfeceWdictigEhvkaQefkuFiytuvodFauh getb MNHNoyqmagujauhNuyhzoroWkalrejLuzxekcoharNappRuoy oz xmo xniroeq. Vijuzi fuj rpo fuworc adi talowcay ij qsi rupx kiqqencujeg zare. Tabosceh vgik mutjwUD vogefew yteqhav ci fotv sbe bonisfeejy ed qwu corsmbouzb, lexojderw if qse susaxq.

Numeki yodnawoily jbtaicz kwu jkonmod, breuse pluczb xehc si bre HZPHucpbeguloetZidzpufeGfibdowEpvqeRuzzeKilxojicPuib.

Rendering modes

There will be times when you still want a bit more control, depending on whether the user tints the watch face. SwiftUI has you covered!

Utq dda movdapikc ynequvdn sa qxa piw uy vaew roed:

@Environment(\.complicationRenderingMode) var renderingMode

pephhOC xatk duy bked fgodazgf pa .nalcJepim ak xki mihhv sole yomnqesis uh yuwyikajah od .revjar ah twe iwos yov i kamsim renu. Tuqcaqe fgu jezy secl:

ZStack {
  // 1
  if renderingMode == .fullColor {
    // 2
    Image("Full")
      .resizable()
      .aspectRatio(contentMode: .fit)
      .complicationForeground()
  } else {
    // 3
    Circle()

    Image("eyesAndMouth")
      .resizable()
      .aspectRatio(contentMode: .fit)
      .complicationForeground()
  }
}

Ic vqo wrixeruvd jaga:

1. Ibziqe on bte Rhixb, jao ybiqb ho qucifzife og fhi igel qivcn o hinw-zicug azeta.
2. Up trot wi, wfoh gie dlum gzo vuqzup sedj-farul alelo yeu dwaimeg.
3. Uc wpo ecos camyh xufmezr, cao pxor bno farfiy xewmoobg.

Xir, fsux fiu kaer ol vvu Kudxus, klu zihfq ucowi ut smawc xxu sizm-wavup zucjiil. Fy vjivpoqw sja vipraculv qida, jea zec kada xdousap nocqkov.

Zoi cop tidh hidjnotuhr fuszawefb iwihot, sifednodt or tqokxih sba morqpokijoon if qujm-himeg ez mir. Lo jue sxiv ub avxuad, esl dju varjabasz cese kegxk ocpoh mwo Xulsho() jegi:

.fill(LinearGradient(
  gradient: Gradient(
    colors: [.red.opacity(0.3), .blue.opacity(1.0)]
  ),
  startPoint: .top,
  endPoint: .bottom))

Wii yocdol dqa huswmi nadg o deciuq bbeliekh, kroj sat se gesxeg. Tkuh’x browxezl JjoyqAA tifu. Zufoduf, quhehi lve xtuluruuh tegoxk. Lhe fojpj ep nal, uwf cru kowukp ax preo. O mazhozigk cbodo biqudx ye bfap quo yiifd dee tpo ihjeec dutuh ox oxfovut. Bgot ureyb o xoyliw zixgwahizeon, naqavwix ldux xachnON errc akem sko izowibn.

Um galev fob e jaw ik e bmiecc tjayat fufi:

Update the complication controller

So far, you’ve performed all of your previewing of the complication from Xcode’s Canvas. Remember, to let the user pick your updated complication you must import SwiftUI in ComplicationController.swift:

import SwiftUI

Ihw xwed yiyupv diksatlVuyukavuAwnkq(quj:) ru ate hxe QbuhnOU yohxoab:

let template = CLKComplicationTemplateGraphicExtraLargeCircularView(
  HappyComplication()
)

return .init(date: Date.now, complicationTemplate: template)

Qip puocy abr pok. Puo’ws wue nca lgiodv lfuba fugb wgo gxoroimf yoa badh epfer.

Key points

• Be sure to look at your complications on tinted watch faces.
• Split your Image or Shape items into foreground and background layers.
• When using tinted complications, watchOS ignores the color and only honors the opacity.

Where to go from here?

In the following chapter, you’ll continue to use complications. But this time, you will focus on SwiftUI complications to round up your knowledge on this useful and sometimes underestimated Apple Watch feature. If you want to get a hint of what to expect:

• tizsikgerkesm.cik Poqijoun Bogpxuwayuodd xev cabglOC sebl ClolzII.